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Preface 


What This Manual Can Do For You 


This publication is a reference for programmers who use the IBM_ Series/1 assembler 
language. It gives specific information about assembler language functions and coding 
specifications. 


How This Manual Is Organized 

e Chapter 1 gives a brief introduction to the assembler and its features. 

e Chapter 2 discusses the structure of the assembler language. It also explains the coding 
rules you must follow in coding an assembler-language program. 

e Chapter 3 describes the characteristics of the Series/1 processors. It explains 
register usage, addressing modes, and other information you should understand to 
effectively use the assembler. 

e Chapter 4 describes the machine instructions. It explains the function of each 
instruction and how to code it. For most instructions, this chapter gives examples to 
help you better understand how the instructions work. 

e Chapter 5 describes the assembler instructions. It explains what they do and how to 
code them, then gives examples of their use. 

e Chapter 6 describes the macro language. Programming in macro language simplifies 
coding, reduces the chance for making errors, and ensures that standard sequences of 
instructions are coded. 

e Chapter 7 describes in detail the program listing and record formats produced by the 
assembler. 

e The appendixes offer conversion tables, a summary of constants, a summary of the 
macro language, a priority list for assembler instructions, a summary of assembler 
instructions, and a reference aid for coding I/O instructions. 

Each chapter of this publication is a separate module. This organization allows you to 
use the chapters as published or to combine them with information from other sources. 

Each chapter has a detailed table of contents. A master index, listing all subjects, is 
included at the end of the manual. 


What You Should Know Before You Begin 
You should be familiar with the concepts of modular programming, and you should be 
experienced in assembler-language coding. 


Corequisite Publications 
IBM _ Series/1 Base Program Preparation Facilities User’s Guide, SC34-0072 
IBM 4955 Processor and Processor Features Description, GA34-0021 
IBM 4953 Processor and Processor Features Description, GA34-0022 
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THE ASSEMBLER LANGUAGE 


Machine Instructions 


Assembler Instructions 


Macro Instructions 


Assembler language is a symbolic programming language that resembles machine language 
in form and content. It is made up of statements that represent instructions and 
comments. The instruction statements are the working part of the language and are 
divided into three groups: 


e Machine instructions 
e Assembler instructions 
e Macro instructions 


A machine instruction is the symbolic representation of a hardware instruction in the 
Series/1 instruction set. Machine instructions are described in Chapter 4 of this 
manual. 


An assembler instruction is a request to the assembler program to perform certain 
operations during the assembly of a source module; for example, defining data constants, 
defining the end of the source module, and reserving storage areas. Except for the 
instructions that define constants, the assembler does not translate assembler instructions 
into object code. The assembler instructions are described in Chapter 5 of this manual. 


A macro instruction is a request to the assembler program to process a predefined 
sequence of code called a macro definition. From this definition, the assembler generates 
machine and assembler instructions which it then processes as if they were part of the 
original input in the source module. 

You can prepare macro definitions, then call them by coding the corresponding macro 
instructions. A complete description of the macro language, including the macro 
definition, the macro instruction, and the conditional assembly language is given in 
Chapter 6 of this manual. 


THE ASSEMBLER PROGRAM 


The assembler program, also referred to as the assembler, processes the machine, 
assembler, and macro instructions you have coded in the assembler language and produces 
an object module in machine language. 

The assembler processes the three types of assembler language instructions at different 
times during its processing sequence. You should be aware of this processing sequence in 
order to code your program correctly. The following diagram relates the assembler 
processing sequence to other times at which your program is processed and executed. 
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The assembler processes instructions at two distinct times. It processes macro 
instructions at preassembly time, and it processes machine instructions and assembler 
instructions at assembly time. 

The assembler also produces information for other programs. The linkage editor uses 
such information to combine object modules into load modules. Finally, at execution 
time, the Series/1 executes the load module. 


Linkage 
editor 








CODING AIDS 


It is normally difficult to write an assembler language program using only machine 
instructions. The assembler provides some coding aids that make this task easier. They are 
summarized next. 


Symbolic Representation of Program Elements 


Symbols greatly reduce programming effort and errors. You can define symbols to 
represent storage addresses, displacements, constants, registers, and other elements that 
make up the assembler language. These elements include operands, operand subfields, 
terms, and expressions. Symbols are easier to remember and code than numbers; also, 
they are listed in a symbolic cross-reference table which is printed in the program listing. 
Thus, you can easily find a symbol when searching for an error in your code. 


Variety of Data Representation 


Relocatability 


Addresses and Addressing 


Register Usage 


You can use decimal, binary, hexadecimal, or character representation, which the 
assembler converts for you into the binary values required by the machine instructions. 


The assembler produces an object module that can be relocated from the originally 
assigned storage area to any other suitable main storage area without affecting program 
execution. The linkage editor does the relocation. 


Each byte in main storage is specified by a unique numeric address. When you write a 
program, you are essentially telling the computer what addresses are involved in the 
operation you want it to perform. You are usually not concerned with the specific main 
storage locations, because the assembler keeps track of the location of the statement in 
your program (relative to the beginning of your program). The assembler assigns the 
proper address to each assembled machine-language instruction. 

To keep track of the locations, the assembler uses a location assignment counter. The 
counter is set to zero at the beginning of an assembly unless your program specifies 
otherwise. The counter is then increased by the number of bytes of main storage that 
each instruction needs. In this way, each statement is assigned an address relative to the 
beginning of the program. The assembler can then assign the addresses and displacements 
that are required when it produces the object program. (A displacement is the difference 
between the counter value of one statement and that of another.) 

When your program is link-edited, each statement for which storage is allocated takes 
on a relocated address, which is equal to the beginning main-storage address of the 
program plus the location counter value for that instruction (based on a beginning 
location counter value of zero). 

To locate data, most machine instructions refer to a storage address. The Series/1 
uses a variety of methods (called addressing modes) to find the data you request in your 
machine instructions. Addressing modes are described in Chapter 3; how you use them is 
discussed in Chapter 4. 


Any one of the eight general-purpose registers can be used to hold a value, an address, or 
a displacement for manipulating data, maintaining counters, or determining the address of 
a particular instruction or storage location. 

The instruction address register contains the address of the next instruction to be 
executed unless a branch instruction breaks the normal sequence. When a branch occurs, 
the contents of the instruction address register change because the program branches to 
an instruction not immediately following the current instruction. 
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Segmenting a Program 


You can code a program in sections and later combine the sections into the executable 
program. Sections are assembled in any combination, individually or grouped. You 
arrange the sections in the order required for proper execution of the program during the 
combining process. The combining process is called linking and is performed by the 
linkage editor program. 

Dividing a large program into several sections and assemblies has certain advantages: 

e More than one programmer can code sections of the program. Each can assemble and 
debug his sections independently of the others. 

e The linking process is much faster in terms of computer time. You can assemble a 
section of the program and link the new section to the already assembled program. 
This uses less computer time than assembling the entire program. 

e Sections that are common to more than one program are assembled only once. You 
can then link the common sections to the unique sections of each program. You again 
reduce computer time and also have shorter assembly listings that are easier to debug. 

e You can configure a program to various main storage requirements much more easily 
by linking the sections into different combinations of storage loads or phases. Of 
course, you must make provisions for these variations in your program logic. 


Two types of program sections can be defined in the assembler language—control 
sections and dummy sections. Control sections define the object code, that is, machine 
instructions and data definitions. A dummy section describes to the assembler the format 
of a control section in another assembly. Dummy sections do not appear in the output 
module of an assembly. The linking process combines only control sections. 

The following assembler instructions define the beginning and end of the various 
sections in your assembly. 


e START and CSECT instructions define the beginning of a control section. START is 
used only to define the first control section in an assembly. 

e The DSECT instruction defines the beginning of a dummy section. 

e The end of any type of section is defined when another section is started. The END 
instruction defines the end of all sections in an assembly. 


Linkage Between Source Modules 


You can create symbolic linkages between separately assembled source modules. This 
allows you to refer symbolically from one source module to data defined in another 
source module. You can also use symbolic addresses to branch between modules. 

Combining separately assembled control sections successfully depends on the 
techniques for symbolic linkages between the control sections. For example, symbols can 
be defined in one module and referred to in another. The linkage editor then completes 
the linkage, using the information passed to it by the assembler. Not only is the linkage 
symbol defined (used as a name), it must also be identified to the assembler by means of 
an ENTRY assembler instruction unless the symbol is the name of a CSECT or START 
statement. After a symbol is identified as one that names an entry point, another module 
can then use that symbol to bring about a branch operation or a data reference. 

A module that refers to a linkage symbol defined in another module must identify it as 
an externally defined symbol used to bring about linkage. The EXTRN or WXTRN 
assembler instructions identify such symbols. 

Symbolic linkage can also be achieved by means of the V-type or W-type address 
constant, or by means of the BALX or BX machine instruction. Each constant is an 
external reference since it is created from an externally defined symbol that need not be 
identified by an EXTRN or WXTRN statement. The V-type or W-type address constant 
can be used to branch to other modules or to refer to data in those modules. 


Note. In a single assembly, the total number of control sections, dummy sections, unique 
symbols in EXTRN and WXTRN statements, V-type address constants, W-type address 
constants, BALX instructions, and BX instructions cannot exceed 254. 
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Program Listing 


The assembler produces a listing of your source module, including any generated 
statements, and the object code assembled from the source module. You can control the 
content of the listing to a certain extent. The assembler also prints messages about actual 
errors and warnings about potential errors in your source module. A complete description 
of the program listing is given in Chapter 7 of this manual. 
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This chapter describes the coding conventions that you must follow in writing assembler 
language programs. Assembler language statements are usually written on a coding form 
before they are entered as source statements through some form of input to the system. 
You can write assembler language statements on the standard coding form (GX28-6509). 
Columns 1—72 of this form correspond to the positions on a source statement entered at 
the operator station. 


IBM System/360 Assembler Coding Form GX28-6800-6 U/M 060° 


Printed in U.S.A, 
fen Fle ie 
NSTRUCTIONS 
DATE ey 
of ok. she Ue 38g = f L245 kes . S saoczi #: i tr ee: f= Sp SS Se. of 









‘CARD ELECTRO NUMBER 


3” 77 7) 71 +73 
* A standard cord form, IBM electro 0500, le aveltable for punching source sttements from ts form. | 
inetructions for veing thie form are in any 18M System/300 ssembter jenguegs reference manual, 
form to IBM Nordic Laboratory, Publications Development, * No of forme per pad may vary slightly. 


Ackiress eomments 
Box 962, 5-181 08 LidingS 9, Sweden, 


Field Boundaries 


Assembler language statements usually occupy one 80-column line on the standard form. 
(For statements occupying more than 80 columns, see “Continuation Lines” in this 
chapter.) Note that any printable character entered as a position in a source statement is 
reproduced in the listing printed by the assembler. Each line of the coding form is divided 
into three main fields: 


e The statement field. You must write instructions and comments in the statement field 
(columns 1—71). Any continuation lines needed must start in column 16 or beyond 
and end in column 71 or sooner. 

e The continuation indicator field. Column 72 is the continuation indicator field. A 
nonblank character in column 72 indicates that the current statement is continued on 
the next line. Column 72 must be blank if a statement is completed on the same line; 
Otherwise the assembler treats the statement that follows on the next line as a 
continuation line of the current statement. 

e The identification and sequence field. The identification and sequence field (columns 
73—80) can contain identification characters or sequence numbers, or both. 
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Continuation Lines 
To continue a statement on another line: 


1. Enter a nonblank character in the continuation indicator field (column 72). This 
nonblank character must not be part of the statement coding. An operand field can 
be continued by coding it up through column 71, or by terminating it with a comma 
followed by at least one blank. 

2. Continue the statement on the next line, starting in the continue column (column 16 
or beyond). Columns 1—15 must be blank. 


Only one continuation line is allowed for a single assembler language statement. 
However, macro instruction statements and the prototype statement of macro definitions 
can have as many continuation lines as needed. When more than one continuation line is 
needed, enter a nonblank character in column 72 of each line that is to be continued. 


Comments Statement Format 


Comments statements are not assembled as part of the object module, but are only 
printed on the assembly listing. You can write as many comments statements as you 
need, as long as you follow these rules: 


1. Comments statements require an asterisk in column 1. 


Note. Internal macro definition comments statements require a period in column 1, 
followed by an asterisk in column 2 (for details see “Internal Macro Comments 
Statements” in this chapter). 


2. You can use any characters, including blanks and special characters, of the character 
set. 

3. Comments statements cannot be continued. Code comments statements in the 
statement field (columns 1—71) and do not let them run over into the continuation 
indicator field. 

4. Comments statements must not appear between an instruction statement and its 
continuation lines. 


Instruction Statement Format 


The statement field of an instruction statement must include an operation entry and can 
contain one or more of the following entries: 

e A name entry 

e An operand entry 

e A remarks entry 

The standard coding form is divided into fields that provide fixed positions for the name, 
operation, and operand entries. 

1. An 8-character name field starting in column 1 

2. A 5-character operation field starting in column 10 

3. An operand field that begins in column 16 





2-4 SC34-0074 


Adherence to these field positions is called fixed format. 

It is not necessary to code the operation and operand entries according to the fixed 
fields on the standard coding form. Instead, you can write these entries in any position, 
called free format, subject to certain formatting specifications. 

Whether you use fixed or free format, the following general rules apply when you code 
an instruction statement: 

e Write the entries in the following order: name, operation, operand, and remarks. 

e The entries must be in columns 1—71 of the first line and, if needed, in columns 
16—71 of any continuation lines. 

e The entries must be separated from each other by one or more blanks. 

e If used, the name entry must start in column 1. 

e The name and operation entries, each followed by at least one blank, must be in the 
first line of an instruction statement. 

e The operation entry must start in column 2 or later. 


[ FIXED FORMAT STATEMENT. 
L BEL vw R3,. ADCON FREE FORMAT STATEMENT. 


LABEL WW rrr 
| —R3, ADCON ONLY OPERANDS AND REMARKS ALLOWED HERE, oe eere 7 


| WW 3, ADCON NAME ENTRY OMITTED, COLUMN 1 MUST BE BLANK. 





hens fie R3, CONTINUE OPERANDS 
 ADCON ON NEXT LINE 





The name entry identifies an instruction statement. The following rules apply to the 
name entry: 

e It is usually optional. 

e It must be a valid symbol of 1—8 characters at assembly time (after substitution for 
variable symbols, if specified on model statements within macro definitions). 

The operation entry is the symbolic operation vode that specifies the machine, 
assembler, or macro instruction to be processed. The following rules apply to the 
operation entry: 

e It is mandatory. 

e For machine and assembler instructions it must be a valid symbol at assembly time 
(after substitution for variable symbols, if specified on model statements within macro 
definitions). The standard symbolic operation codes are 5 characters or less. 

e For macro instructions it can be any valid symbol of 1—8 characters that is not 
identical to the operation codes for machine and assembler instructions. 

The operand entry has one or more operands that identify and describe the data used 
by an instruction. The following rules apply to operands: 

e One or more operands are usually required, depending on the instruction. 

e Operands must be separated by commas. No blanks are allowed between the operands 
and the commas that separate them. When an operand entry is being continued on the 
next line, the last operand on the first line can be terminated with a comma followed 
by one or more blanks. 

e Operands must not contain embedded blanks, because a blank normally indicates the 
end of the operand entry. However, blanks are allowed if they are included in 
character strings enclosed in apostrophes (for example, C‘ JN’) or in logical expressions 
(see “Logical (SETB) Expressions” in Chapter 6). 
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You can use a remarks entry to comment on the current instruction. The following 
rules apply to the remarks entry: 

e It is optional. 

e It can contain any of the 256 characters of the character set, including blanks and 
special characters. 

e It can follow any operand entry. 

e If an entire operand entry is omitted, remarks are allowed if the absence of the 
operand entry is indicated by a comma preceded and followed by one or more blanks. 
Note. Macro prototype statements and macro instructions without operands cannot 
have a remarks entry, even if a comma is coded as described above. 


ASSEMBLER LANGUAGE STRUCTURE 


Character Set 


Terms 
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This section describes the structure of the assembler language (the various statements 
allowed in the language and the elements that make up those statements). 

A source module is a sequence of instruction and comment statements that make up 
the input to the assembler. There are 3 types of instruction statements: 


e Machine instructions—symbolic representation of machine language instructions, 
which the assembler translates into machine language code 

e Assembler instructions—instructions to the assembler program to perform certain 
operations during assembly of a source module, such as defining data constants and 
reserving storage areas 

e Macro instructions—instructions to the assembler program to process predefined 
sequences of code called macro definitions (from which the assembler generates 
machine and assembler instructions which it then processes as if they were part of the 
original input source module) 


The operand field of machine instructions is composed of expressions, which are 
composed of terms and combinations of terms. Remarks on the instruction statements 
and comments statements are composed of character strings. Terms and character strings 
are both composed of characters. The following paragraphs define these language 
elements. 


Terms, expressions, and character strings used to build source statements are written with 
the following characters: 
e Alphameric characters 
— Alphabetic characters A through Z 
— Special characters $, #, and @ 
— Digits 0 through 9 
e Special characters 
+—,=.*()‘/ & blank 
Note. Character strings can contain any of the 256 characters of the character set. 
Normally, strings of alphameric characters are used to represent data, and special 
characters are used as: 
e Arithmetic operators in expressions 
e Data or field delimiters 
e Indicators to the assembler for specific handling 


A term is the smallest element of the assembler language that represents a distinct and 
separate value. It can therefore be used alone or in combination with other terms to form 
expressions. Terms have absolute or relocatable values that are assigned by the assembler 
or are inherent in the terms themselves. 


Symbols 


The Symbol Table 


A term is absolute if its value does not change upon program relocation and is 
relocatable if its value can be modified to compensate for a change in program origin. 
The types of terms are: 


e Symbols—absolute or relocatable; value is assigned by the assembler 

e Location counter reference—relocatable; value is assigned by the assembler 
e Symbolic parameter attributes—absolute; value is assigned by the assembler 
e Self-defining terms—absolute; value is inherent in term 


You can use a symbol to represent storage locations or arbitrary values. You can write a 
symbol] in the name field of an instruction and and then specify this symbol in the 
operands of other instructions, thus referring to the former instruction symbolically. This 
symbol represents a relocatable address. 

You can also assign an absolute value to a symbol by coding it in the name field of an 
EQU or EQUR instruction with an operand whose value is absolute. Symbols in the name 
field of EQUR instructions can be used in other instruction operands to represent 
registers; symbols in the name field of EQU instructions can be used in other instruction 
operands as displacements in explicit addresses, immediate data, lengths, and implicit 
addresses with absolute values. The advantages of symbolic numeric representation are: 


e You can remember symbols more easily than numeric values, thus reducing 
programming errors and increasing programming efficiency. 

e You can use meaningful symbols to describe the program elements they represent; for 
example, INPUT can name a field that is to contain input data, or INDEX can name a 
register to be used for indexing. 

e You can change the value of one symbol (through an EQU instruction) more easily 
than you can change several numeric values in many instructions. 

e Symbols are entered into a cross-reference table that the assembler optionally prints in 
the program listing. 

The symbol cross-reference table helps you to find a symbol in a program listing, 
because it lists (1) the number of the statement in which the symbol is defined (that is, 
used as the name entry), and (2) the numbers of all the statements in which the symbol is 
used in the operands. 


The assembler maintains an internal table called a symbol table. When the assembler 
processes your source statements for the first time, the assembler assigns an absolute or 
relocatable value to every symbol that appears in the name field of an instruction. The 
assembler enters this value, which normally reflects the setting of the location counter, 
into the symbol table; it also enters the attributes with the data represented by the 
symbol. The values of the symbol and its attributes are available later when the assembler 
finds this symbol used as a term in an operand or expression. 
The assembler recognizes three types of symbols: 


© Ordinary symbols—used in the name and operand fields of machine and assembler 
instruction statements; written as an alphabetic character followed by 0—7 alphameric 
characters (no blanks allowed). For example: BEGIN 

¢ Variable symbols—used only in macro processing conditional assembly instructions; 
written as an ampersand followed by an alphabetic character followed by O—6 
alphameric characters (no blanks allowed). For example: &PARAM 

e Sequence symbols—used only in macro processing conditional assembly instructions; 
written as a period followed by an alphabetic character followed by O—6 alphameric 
characters. For example: .SEQO1 

An ordinary symbol is considered defined when it appears as: 


e The name entry in a machine or assembler instruction of the assembler language, or 
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Restrictions on Symbols 


Predefined Register Symbols 


Unique Definition 
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e One of the operands of the following instructions: BALX, BX, EXTRN, WXTRN. 


Ordinary symbols that appear in instructions generated from model statements at 
preassembly time are also considered defined. 
The assembler assigns a value to the ordinary symbol in the name field as follows. 


e According to the address of the leftmost word of the storage area that contains one of 

the following: 

—Any machine instruction 

—A storage area defined by the DS instruction 

—Any constant defined by the DC instruction 

The address value thus assigned is relocatable, because the object code assembled from 
these items is relocatable. 

e According to the value of the expression specified in the operand of an EQU 
instruction. This expression can have a relocatable or absolute value, which is then 
assigned to the ordinary symbol. 

e According to the value of the expression specified in the operand of an EQUR 
instruction. This expression must have an absolute value in the range O—7, which is 
then assigned to the register symbol. 


The value of an ordinary symbol must be representable in 16 bits. 


The following symbols are predefined by the assembler and reserved for use only as 
register symbols: 


e RO (general-purpose register 0) 
R1 (general-purpose register 1) 
R2 (general-purpose register 2) 
R3 (general-purpose register 3) 
R4 (general-purpose register 4) 
RS (general-purpose register 5) 
R6 (general-purpose register 6) 
R7 (general-purpose register 7) 
FRO (floating-point register 0) 
FR1 (floating-point register 1) 
FR2 (floating-point register 2) 
FR3 (floating-point register 3) 


These symbols are absolute and used only for register reference in machine and assembler 
instruction operands. Any other usage causes an error message to be generated. 
Predefined register symbols appear in the cross-reference listing. 


A symbol must be defined only once in a source module (even a source module that 
contains two or more control sections) with the following exceptions: 


e You can use a duplicate symbol as the name entry of a START, CSECT, or DSECT 
instruction. The first use identifies the beginning of the control section, and 
subsequent uses identify continuations of the control section. A symbol used in the 
name field of a START or CSECT instruction must not also be used in the name field 
of a DSECT instruction. 


e A symbol can appear more than once in the operands of the following instructions: 
—ENTRY 
—BALX 
—BX 
—EXTRN 
—WXTRN 
—DC for V- or W-type address constants 
provided the attributes are not contradictory (that is, the same symbol can be repeated 
in an EXTRN and BALX instruction but cannot be repeated in a WXTRN and 
EXTRN). 


Note. An ordinary symbol that appears in the name field of a TITLE instruction is not 
a definition of that symbol. It can therefore be used in the name field of any other 
statement in a source module. 


Previously Defined Symbols 


The symbols used in the operands of the following instructions must be defined in a 
previous instruction: 

e EQU 

EQUR 

ORG 

DC and DS (in modifier and duplication factor expressions) 


The following sample code indicates the ways symbols can be defined and used: 


APOC RRR EDDY BAM IOD OD ERRINOSE ONIN DOIN AEN MEME N 4 Ce PARSE NNR ORE SSS MENA MIEENE Nita AEN RAIS REARRANGE Mago MEE et See Dna SE TEMG EEE SITES. SAS SI I, Scr gp engotaat Sty t KOE SRT RS AEN RE RRS RRR! ONT RARER 
: : PON in ie easing 
Name Ooyetion are 
ae a Q ‘a a 18 eu oe 
PARED es inonmsggonetong ns SSE ORR antes 7 oe 


g 4 
NID ELK SHC, 


ane 
+ 


Sere snnsvad 


Brae Gomes Tie ‘: 
: : Ed 
= SERA NEON NS 
. 2 
e Seuss 
3 = 
SERN SRE: 
te Pe 
F; g ‘« 
2 
sige Reacorcd Saat eee 
a a ee a 
z 8 
Seer as Ss 
i 
Hy 
a 
ANS eR ee 
& g g 
¥ 
¥ 
g & 
* 


The unique symbols, in the order they were defined, are: 


FIRST XR4 
READER ENTRIES 
PRINTER TABLE 
XR3 SECOND 
INDEX ADCON 
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Location Counter Reference 


The assembler maintains a location counter to assign storage addresses to your program 
statements. You can refer to the current value of the location counter at any place ina 
source module by specifying an asterisk as a term in an operand. 

As the instructions and constants of a source module are being assembled, the location 
counter has a value that indicates a location in storage. The assembler increases the — 
location counter according to the following rules: 


e As each instruction or constant is assembled, the location counter increases by the 
length of the assembled item. 

e The location counter always points to the first byte of the instruction being 
assembled. 

e All references to the location counter in the operand field are relative to the first byte 
of the instruction being assembled. 

e If the statement is named by a symbol, the value of the symbol is the value of the 
location counter. 

The assembler maintains a location counter for each control section in the source 
module. (For complete details about the location counter setting in control sections, see 
“Program Sectioning“ in Chapter 5.) The assembler maintains the internal location 
counter as a 16-bit value. If you specify addresses greater than 65,535, the assembler 
issues the error message ‘AS205S LOCATION COUNTER ERROR’. 

You refer to the location counter reference by coding an asterisk (*). Code an asterisk 
as a relocatable term only in the operands.of: 

@ Machine instructions 
e DC and DS it:structions 
e EQU, ORG, and USING instructions 


The value of the location counter reference (*) is the current value of the location 
counter when the asterisk is specified as a term. The asterisk has the same value as the 
address of the first byte of the instruction being assembled. For the value of the asterisk 
in address constants with duplication factors, see “A-type Address Constant” in Chapter 
5. 

Coding an asterisk in the operand of an assembler language instruction or a machine 
instruction (as part of an address) is the same as placing a symbol in the name field of the 
same statement and then using that symbol in the operand. Be careful how you use this 
technique; inserting or deleting instructions between an instruction and the location it 
refers to makes the displacement from the location counter invalid. 


e Runa ett “ADDRESS 0 OF AWE “INSTRUCT ON nf 


a, Go) rs ADDRESS OF LOC2=—SAME AS CODING: a | 
| : ce oF ee oc _A(LOC2) | - 
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Attribute References 


Self-defining Terms 


Attributes describe the characteristics and structure of the data you define in a program 
(for example, the kind of constant you specify or the number of characters you need to 
represent a value). These attributes are the type (T), count (K), and number (N) 
attributes. 

You can refer to these attributes only in macro definition statements; for full details, 
see “Data Attributes” in Chapter 6. 


A self-defining term lets you specify a value explicitly. With self-defining terms, you can 
specify decimal, binary, hexadecimal, or EBCDIC character data. These terms have 
absolute values and can be used as absolute terms in expressions to represent bit 
configurations, absolute addresses, displacements, length or other modifiers, and 
duplication factors. 

Self-defining terms: 
e Represent machine language binary values 
e Are absolute terms; their values do not change upon program relocation 
e Are padded on the left with zeros if less than one word 

The assembler maintains the values represented by self-defining terms to 16 bits; 
self-defining terms are always considered as positive values in the range zero through 
65,535. 

A decimal self-defining term is an unsigned decimal number. The assembler allows: 
e High-order zeros 
e A maximum of five decimal digits 
e A range of values from zero through 65,535 
Note. A negative number is specified as an expression. For details, see “Expressions”’ later 
in this chapter.’ 


 HIGH-ORDER ZEROS. era 
5 DIGITS Is “MAXIMUM VALUE. aden) 





A binary self-defining term must be coded as the letter B followed by 1—16 binary 
digits enclosed in apostrophes. For example: 


Binary self- Binary 
defining term value 


B‘1111100’ 00000000 01111100 
B‘100’ 00000000 00000100 
B‘1’ 00000000 00000001 
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The assembler assembles each binary digit exactly as specified. 
A hexadecimal self-defining term must be coded as the letter X followed by 1—4 
hexadecimal digits enclosed in apostrophes. For example: 


Hexadecimal 
self-defining 


term 


X‘FFAO’ 


X‘F’ 
X*CO1’ 
X‘7FFF’ 
X‘8000” 
Xx‘0’ 


11111111 
00000000 
00001100 
01111111 
10000000 
00000000 


10100000 
00001111 
00000001 
11111111 
00000000 
00000000 





The assembler assembles each hexadecimal digit into its 4-bit binary equivalent as shown 
above, and allows a range of values from X‘0000’ through X*FFFF’. 
An EBCDIC character self-defining term must be coded as the letter C, followed by 1 or 
2 characters enclosed in apostrophes. When assembling EBCDIC character constants, the 
assembler: 
e Allows any of the 256 8-bit combinations as input. This includes the printable 
characters, including blanks and special characters. 
e Assembles each character into its 8-bit EBCDIC equivalent. 
e Requires that two ampersands or two apostrophes be specified in the character 
sequence for each ampersand or apostrophe required in the assembled term. 


Characters Hexadecimal 
assembled value 


Character 
self-defining 
term 


C*AB’ 
CC 
C3" 


C'D2’ 
Cc 
C#’ 
CRB’ 
Cc €€¢ 
CL’ 69 
C588’ 


X°C1C2’ 
X*°C3’ 
X‘F3’ 
X‘°C4F2’ 
X*40’ 
X‘7B’ 
X50’ 
X*7D’ 
X‘D37D’ 
X‘F550° 


11000001 
00000000 
00000000 
11000100 
00000000 
00000000 
00000000 
00000000 
11010011 
11110101 


11000010 
11000011 
11110011 
11110010 
01000000 
01111011 
01010000 
01111101 
01111101 
01010000 





The assembler maintains the values represented by self-defining terms as 16 bits. If a term 
is used as the operand on a byte immediate instruction, the low-order byte of the term is 
placed in the immediate field. The high-order byte must be zero. 


EXPRESSIONS 
You can use an expression to code: 


An address 

An absolute value 
An explicit length 

A length modifier 

A duplication factor 
A complete operand 


You can write an expression with a simple term or as an arithmetic combination of terms. 
The assembler reduces multiterm expressions to single values. Thus, you do not have to 
compute these values. For example, expressions are used in the following instructions as 
indicated: 
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Resp DATAtH : EXPRESSION USED AS AN ‘ADDRESS. 
Wl 542,R3_ nia AN ABSOLUTE VALUE , a 


 epanegerA) AS AN EXPLICIT LENGTH, Riese 
. (ALPHA~BETA+2)C_ tae A DUPLICATION FACTOR, 
f_ -LABELS OR AS A COMPLETE OPERAND. 





Absolute Expressions 


Register Expressions 


Expressions have absolute or relocatable values. Whether an expression is absolute or 
relocatable depends on the attributes of the terms it contains. You can use the absolute 
or relocatable expressions described in this section in a machine instruction or any 
assembler instruction other than a conditional assembly instruction. The assembler 
evaluates relocatable and absolute expressions at assembly time. Throughout this manual, 
the word “‘expressions”’ refers to these types of expressions. 


Note. The three types of expressions that you can use in conditional assembly 
instructions are arithmetic, logical, and character. They are evaluated at preassembly 
time. In this manual they are always referred to by their full names; they are described in 
detail in Chapter 6. 


An expression is absolute if its value is not changed by program relocation; it is 
relocatable if its value is changed upon program relocation. 


The assembler reduces an expression to a single absolute value if the expression: 

e Is composed of a symbol with these values, a self-defining term, or any arithmetic 
combination of absolute terms 

e Contains relocatable terms, alone or in combination with absolute terms, and if all 
these relocatable terms are paired 

An expression can be absolute even though it contains relocatable terms, provided that 
all the relocatable terms are paired. The pairing of relocatable terms cancels the effect of 
relocation. The assembler reduces paired terms to single absolute terms in the 
intermediate stages of evaluation. The assembler considers relocatable terms as paired 
under the following conditions: 

e The paired terms must be defined in the same control section of a source module (that 
is, have the same relocatability attribute). 

e The paired terms must have opposite signs after all unary operators are resolved. In an 
expression, the paired terms do not have to be contiguous; that is, other terms can 
come between the paired terms. 

e The value represented by the paired terms is absolute. 


You may code register references as expressions by following the rules for coding 
absolute expressions. There must be at least one register symbol present in a expression 
to give it the register attribute. 

Note. You can only use register symbols in register expressions. To ensure accuracy of the 
cross reference listing, code the register symbol as the first term of the register expression. 
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ABLE 
BAKER 
CHARL IE 





LOCREF 


ica ba 


ABSC 


EXAMPLE 
EXAMPLE2 
EXAMPLE3. 
EXAMPLEA 


SECOND 


EASY 
FOX 


CSECT 


rope 
rk 


bs 


QU ABS 
EqQU. 15 
EQU 


EQU 


DS 


END 
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ie 
Xx 
x 


seer 


we 
eg EOD 





ABSA+ABSC#5 
BARER-ABLE/ABSBOABSD 


| Unpaired relocatable terms 


“ABLE, BAKER, CHARLIE, AND.  LOCR 
PAIRED. IN THE SAME. EXPRESSION. 
LOCATION COUNTER REFERENCE 


“THE 0 OPERANDS OF EXAMPLE], 


The following sample code shows some relocatable and absolute terms: 







ARE. RELOCATABLE TERMS, THAT CAN BE. 


ABSA, ABSB, AND ABSC ARE 
FU 128 EQUATED TO "ABSOLUTE TERMS. 
EQ 27 : 


EXAMPLE2, EXAMPLE3, AND meee) 
EXAMPLE4 ARE ABSOLUTE EXPRESSIONS. uk 


DELTA, EASY, AND FOX x ARE 
- RELOCATABLE TERMS THAT CAN BE 
PAIRED IN THE SAME EXPRESSION. 





Paired relocatable terms Absolute expressions 


BAKER — ABLE ABLE + ABSA — BAKER 
CHARLIE — ABLE DELTA — EASY + ABSC 
f LOCREF — CHARLIE 
_4. DELTA ~ EASY 


FOX — DELTA + BAKER — CHARLIE 


Relocatable expressions 


BAKER + ABSA 
CHARLIE + X‘FF’ 
FOX — 5*(BAKER — CHARLIE) 


Relocatable Expressions 
A relocatable expression is one whose value changes, for example, by a factor of 100, if 
the object module into which it is assembled is relocated 100 bytes away from its 
originally assigned storage area. The assembler reduces a relocatable expression to a single 
relocatable value if the expression: 
e Is composed of a single relocatable term, or 
e Contains relocatable terms, alone or in combination with absolute terms, and 
— All the relocatable terms but one are paired. Note that the unpaired term gives the 
expression a value with the relocatability attribute of that term. The paired 
relocatable terms and other absolute terms increase or decrease the value of the 
unpaired term. 
— The sign preceding the unpaired relocatable term must be positive, after all monadic 
operators have been resolved. 


Complex Relocatable Expressions. Complex relocatable expressions, unlike relocatable 
expressions can contain: 

e Two or more unpaired relocatable terms, or 

e An unpaired relocatable term preceded by a negative sign. 

Complex relocatable expressions can be used only in A-type address constants. (See 
**A-type Address Constant” in Chapter 5.) 

In the following sample code, EXAMPLE1, EXAMPLE2, EXAMPLE3, and EXAMPLE4 
are equated to valid relocatable expressions (that is, they belong to the same control 
section and have the same relocatability attribute as the relocatable terms in the 
expressions): 


FIRST — CSECT 


ABLE posCéF FQ! ABLE, BAKER, AND CHARLIE 
BAKER DC F!3! ARE RELOCATABLE TERMS. | 
CHARLIE DC FX! | . 


ABSA EU ig | ABSA, ABSB, AND ABSC 
ABSB = EQU. ss *=ABLE ARE ABSOLUTE TERMS. 
ABSC EQU 1@*(BAKER-ABLE). Oe 


EXAMPLE! EQU ABLE+ABSA+1@ BAKER=ABLE AND CHARLIE=ABLE ARE. 
EXAMPLE2 EQU BAKER@ABLE+CHARLIE PAIRED RELOCATABLE TERMS - 
EXAMPLE3 EQU BAKER+2+(CHARLIE-ABLE) | 

eh: ENT BN EXTERNAL 


EXAMPLEA Dc A(ABLE=EXTERNAL) COMPLEX RELOCATABLE EXPRESSIONS ARE 
* VALID IN A-TYPE ADDRESS CONSTANTS 
We | ONLY 
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Rules for Coding Expressions 


Evaluation of Expressions 
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The rules for coding an absolute or relocatable expression are: 


An expression must not begin with an operator other than the unary minus or unary 
plus, and must not contain two operators in succession. 

Unary operators: —, + 

Binary operators: +,-, *, / 

Valid expressions: —2, INDEX+4 

Invalid expressions: /2, At+/2 

An expression must not contain two terms in succession. 

Valid expressions: ABLE*BAKER 

Invalid expressions: ABLEBAKER, X‘FF’(10*A),C‘A’B‘101’ 

No blanks are allowed between an operator and a term. 

Valid expression: ABLE*BAKER | 

Invalid expression: ABLE * BAKER 

An expression can contain up to 16 terms and up to five levels of parentheses. Note 
that parentheses that are part of an operand specification do not count toward this 
limit (see ‘Parentheses in Instruction Operands” in this chapter). 

A single relocatable term is not allowed in a multiply or divide operation. Note that 
paired relocatable terms have absolute values and can be multiplied and divided if they 
are enclosed in parentheses. 

Context determines whether an asterisk (*) is the binary operator for multiplication, 
the location counter reference, or the indirect addressing indicator. 

Valid expressions: ABSA+*, *+3 

Invalid expressions: A*/B, ABSA+*ABSB, *3 


The assembler reduces a multiterm expression to a single value as follows: 


e [It evaluates each term. 


It performs arithmetic operations from left to right; however, multiplication and 
division are performed before addition and subtraction. 

In division, it gives an integer result; any fractional portion is dropped. Division by 
Zero gives a zero result. 

Every expression is computed using 32-bit arithmetic. 

In parenthesized expressions, the assembler evaluates the innermost expressions first 
and then considers them as terms in the next outer level of expressions. It continues 
this process until the outermost expression is evaluated. It is assumed that the 
assembler evaluates paired relocatable terms at each level of expression nesting. The 
expression A-(X‘FF’*2+B-(C/2*D)) is evaluated in the order: 

1. Evaluate C/2*D; call the result result]. 

2. Evaluate X‘FF’*2+B-vesult/; call the result result2. 

3. Evaluate A-result2. 

Expression values are maintained internally to 32 bits during assembly. Negative 
results are carried in twos complement form, and intermediate results can range from 
—2°' through 2?'—1. However, the final value of an expression must be in the 
allowable range for the instruction. For most instructions, that range is —65,536 
through 65,535. The one exception is DC type A with length 4. That instruction 
initializes a doubleword value, and therefore can be in the range —2?' to 23!—1. 


The following examples indicate the order of evaluation of expressions: 


Absolute Assumed Value of 
Expression | Values Expression 
| 15 
10 
5 
5 
0 
5 
0 


A+10/B 
(A + 10)/B 





Parentheses in Instruction Operands 
Two types of parentheses may be used in instruction operands: 


© Syntactic parentheses delimit the elements of an operand. Whenever the contents of a 
register are to be used in an effective address calculation, that register reference is 
enclosed in syntactic parentheses. The following operand forms use syntactic 
parentheses: 


(reg) 

(reg)t 

(reg)* 

(reg addr) 

(reg,addr)* 

disp(reg disp )* 

(reg disp )* 

disp(reg)* 

See Chapter 4 for an explanation of these forms of addressing. 

e Arithmetic parentheses are used to combine the terms of an arithmetic expression. 
They may be used in combination with syntactic parentheses subject to the following 
rules: 

1. Any occurrence of arithmetic parentheses must be preceded or followed by an 
arithmetic operator (+,-,*,/) or the indirect addressing indicator (*). The following 
examples show valid syntactic/arithmetic parentheses combinations: 


(LOC + 4)x addr 
(CR2 + 1)*2) (reg) 
(Ri + 3)/2 reg 
(R2, LOC + (6*D)) (reg, addr) 















2. No operand may be completely enclosed in arithmetic parentheses. That is, the 
following are invalid: 
((ADDRA)*) where ADDRA is an ordinary symbol and the intended addressing 
mode is addr*. 
((R1+4)-3) where the intended addressing mode is reg; the outer arithmetic 
parentheses will be interpreted as syntactic causing address mode (reg) to be 
generated. 
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INTRODUCTION 


This chapter describes the characteristics of the IBM 4953 Processor and the IBM 4955 
Processor. All information in this chapter applies to both processors, unless specifically 
noted otherwise. This chapter explains register usage, addressing modes, and other 
information you should understand to effectively use the assembler. 


REGISTERS 


Each processor has one Interrupt Mask Register (IMR) and one Processor Status Word 
(PSW). Each priority interrupt level has eight general-purpose registers, one Instruction 
Address Register (IAR), one Address Key Register (AKR) (4955 Processor only), and one 
Level Status Register (LSR). All of the preceding are 16-bit registers. Optionally, each 
level can have installed four 64-bit floating-point registers (4955 Processor only). 


Registers Fitted on a Per-Level Basis 


Each of the four levels on the system has the following registers available to the software: 


General registers (RO—R7). Also referred to simply as registers, these are eight 16-bit 
general-purpose registers, whose selection is controlled by the R fields in instructions. 


Floating-point registers (FRO—FR3) (4955 Processor only). Four 64-bit floating-point 
registers are provided with the floating-point optional feature. They are selected by the R 
fields in floating-point instructions. 


Instruction address register (IAR). The IAR contains the address of the leftmost byte of 
the next instruction to be executed. 
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Address Key Register (AKR) (4955 Processor only). This 16-bit register contains three 
address keys and an address key control bit associated with address space management 
and the storage protection mechanism. Separate 3-bit fields contain an address key for (1) 
instruction address space, (2) operand1 address space, and (3) operand2 address space. 
For more information, see Chapter 8 of JBM 4955 Processor and Processor Features 
Description, GA34-0021. 


Equate operand spaces 

Not used, always zero 

Not used, always zero 

Not used, always zero 

Not used, always zero 
Operand 1 key (bit 0) 
Operand | key (bit 1) 
Operand 1 key (bit 2) 

Not used, always zero 
Operand 2 key (bit 0) 
Operand 2 key (bit 1) 
Operand 2 key (bit 2) 

Not used, always zero 
Instruction space key (bit 0) 
Instruction space key (bit 1) 
Instruction space key (bit 2) 

















Level status register (LSR). This 16-bit register contains information about the status of 
an interrupt level. It has this format: 


Even indicator 

Carry indicator 
Overflow indicator 
Negative result indicator 
Zero result indicator 
Not used, always zero 
Not used, always zero 


Not used, always zero 
Supervisor state 

In process 

Trace 

Summary mask 

Not used, always zero 
Not used, always zero 
Not used, always zero 
Not used, always zero 


Bits not used in the LSR are always zero. 


Registers Fitted on a Per-System Basis 
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The registers discussed in this section are addressable through assembler-language 
instructions. 


Interrupt mask register (IMR). A 16-bit register used for control of interrupts. Bit zero 
controls level 0, bit one controls level 1, and so on. A one in bit position N enables 
interrupts on level N, while a zero disables level N. 


Processor status word (PSW). The PSW is a 16-bit register that reports the specific 
condition that caused an exception interrupt (program check, machine check, or soft 
exception check). The PSW contains the following: 


00 


Specification check 
Invalid storage address 

Program check 5 Privilege violate 
Protect check 


Either program check or Invalid function 
soft exception trap 


Floating-point exception 
Stack exception 
Not used 















Soft exception trap 







Storage parity check 
Not used 

CPU control check 
I/O check 









Machine check 







Sequence indicator 
Auto-IPL 
Translator enabled 


13 
14 
Power/Thermal Power/Thermal warning 


Bits not used in the PSW are always zero. 








Status flags 





Console Data Buffer. A 16-bit register that is accessible with the full-function console. 
Issue the CPCON instruction to read this buffer. 


NUMBER REPRESENTATION 
Operands can be signed or unsigned. An unsigned number is a binary integer in which all 
bits contribute to its magnitude. A storage address is an example of an unsigned number. 
Signed positive numbers are represented in true binary notation with the sign bit 
(high-order) set to zero. Signed negative numbers are represented in twos complement 
notation with a one in the sign bit. To get the twos complement of a number, invert each 
bit of the number and add a one to the low-order bit position. 

When the number is positive, all bits to the left of the most significant bit of the 
number, including the sign bit, are zero. When the number is negative, all bits to the left 
of the most significant bit of the number, including the sign bit, are set to one. | 

Twos complement notation does not include a negative zero. The maximum positive 
number consists of an all-one integer field with a sign bit of zero (7FFF). The maximum 
negative number (the negative number with the greatest absolute value) consists of an 
all-zero integer field with a one-bit for sign (8000). 
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INDICATORS 


A single set of add and subtract integer arithmetic operations performs both signed 
arithmetic and unsigned (that is, binary or logical) arithmetic. The carry and overflow 
indicators are set to reflect the result in both cases. 

For signed addition and subtraction, the overflow indicator signals a result that exceeds 
the representation capability of the system. When an overflow occurs, the carry indicator 
and the contents of the result operand together form a valid result of which the carry 
indicator is the sign bit for addition and the complement of the sign bit for subtraction. If 
there is no overflow, the carry indicator contains no information about the result. 

For unsigned addition and subtraction, the carry indicator signals that: 

e On an add instruction, a carry out of the high-order bit position has occurred 
e Ona subtract operation, a borrow beyond the high-order bit position has occurred 

When a carry is indicated on an add operation, the carry indicator and the result 
operand together form a valid result of which the carry indicator is the most significant 
bit. 

When a borrow is signaled on a subtract operation, the result is in twos complement 
form. The overflow indicator contains no information about unsigned addition or 
subtraction operations. 

The following example shows how the processor performs the subtraction, with respect 
to the setting of the carry indicator. 


Add Complement (Subtract) 


+6 0110 
ACY) 1001 


1111 ——_—_—_—_—_——=p>-—_ No carry out, carry indicator on 


If the same operation were to be done with the binary subtract method, we see that a 
borrow out would occur: | 


Binary Subtract 


0 11010 
1 10 0 010 
+6 0 1 0 0 
(+7) O11 1 


——— 1 1 1 1 gee — Borrow out of Bit 0, 
Carry indicator on 


The hardware adds or subtracts a negative and positive number by using the add 
complement method. The operations are identical in the hardware, except that the carry 
indicator settings are different for add and subtract. 

The following examples show how the hardware adds and subtracts numbers that 
produce the same result: 


Add 
+3 0011 
+(—4) 1100 
D111 pe =NO carry out, carry indicator off 
Subtract 
+3 0011 
—(+4) 1100 


1hd_Q“a00 eR _—___™™ Nocarry out, carry indicator on 
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The following examples show how the hardware adds and subtracts, with respect to the 
overflow indicators. The processor recognizes an overflow condition by observing the 
internal carries both into and out of the high-order bit position (the sign bit). If the 
carries disagree, an overflow condition exists. If they agree, there is no overflow. There 
are four possibilities: 

e No carry in and no carry out (carries agree—no overflow) 
e Both carry in and carry out (carries agree—no overflow) 
e Carry in, but no carry out (carries disagree—overflow) 

e Carry out, but no carry in (carries disagree—overflow) 


The four possible cases are shown in the following examples. Decimal equivalents are 
given for comparison. 


Example 1 — No Overflow 


LLL 1) gre Carries 
+62 0011 1110 
+27 0001 1011 


+ 89 0101 1001 


In this straightforward addition, there is neither a carry into the high-order bit position 
nor a carry out; therefore, there is no overflow. The carry indicator is off. 


Example 2 — No Overflow 
Lo oLL1) Le Carries 


+62 0011 1110 
=—21 1110_ 0101 
+35 0010 0011 


Here there is both a carry in and a carry out; hence, no overflow. The carry indicator is 
on. 


Example 3 — Overflow 
VL Le Carries 


+62 0011 1110 
+89 0101 1001 
+151 1001 Ol111 


Here there is a carry into the high-order position, but no carry out. Since the overflow 
indicator is on, the result has exceeded the capacity of the system. The result is an 
unsigned binary integer, and the carry indicator contains the sign bit. The overflow 
condition is also evident from the decimal result 151, which exceeds 127, the maximum 
value that can be represented in eight bits. 


Example 4 — Overflow 


1 1] eee Carries 
—62 1100 0010 
—89 1010 O111 
—-151 0110 1001 


In this example, there is a carry out of the high-order bit position, but no carry in. This 
causes an overflow condition. The carry indicator is on. As in the previous example, the 
result is an unsigned binary integer with the carry indicator containing the sign bit. Again, 
the presence of overflow is evident from the decimal result. 
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Other Uses of Indicators 


STORAGE ADDRESSING 
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The even, carry and overflow indicators contain the condition code following an I/O 
instruction or interrupt. The even indicator is bit 0 of the condition code, the carry 
indicator is bit 1, and the overflow indicator is bit 2. For detailed information about this 
use of indicators, refer to the processor description manual for your processor. See /BM 
4955 Processor and Processor Features Description, GA34-0021. 

The carry indicator is also used to reflect the value of the last bit shifted out of the. 
target register on shift left logical operations. The overflow indicator is used in these 
Operations to indicate whether bit 0 of the shifted register has changed (if bit 0 has 
changed, the sign of the number has changed). 

The carry indicator is used on shift left logical and count operations to reflect the value 
of the last bit shifted out of the register. 

A compare operation affects the indicators in the same manner as a subtract operation. 
Compare instructions are usually used in conjunction with conditional branches or jumps. 
The specified conditions in conditional branches and jumps are named with respect to the 
indicators, so that in all compare instructions the subtracted-from operand is compared 
relative to the other operand. For example, in a Compare Word instruction (CW R1,R2) 
where the contents of R1 are subtracted from the contents of R2, the indicators reflect 
arithmetically less than if the contents of R2 are arithmetically less than the contents of 
Rl. 

The indicators are tested according to a selected condition on a conditional branch or 
jump instruction. For a discussion of the conditions set by these indicators, see “Using 
Compare Instructions” in Chapter 4. | 

Multiplication and division always operate on signed numbers. The indicator settings for 
these operations are described in Chapter 4. 

Since the complement of the maximum representatable negative number is itself not 
representable, an attempt to complement this number turns on the overflow indicator. 

The result indicators are the zero, negative, and even indicators. A positive result is 
indicated when the zero and negative indicators are both zero. These indicators reflect the 
result of the last arithmetic or logical operation performed. See the individual instruction 
descriptions in Chapter 4 for details of indicator setting. 

All indicators are changed by the data associated with the Set Indicators (SEIND) and 
Set LSB (SELB) instructions. 

Indicators (carry, overflow, zero, negative and even) are set or reset at the end of each 
floating-point instruction. Whether each is set or reset is described in the detailed 
instruction descriptions in Chapter 4. 


All storage addresses are 16-bit, unsigned, binary integers. The direct address range of the 
system is 64KB. The addressable unit of main storage is the byte, and all references to 
storage locations are byte addresses. Instructions refer to bits, bytes, words, doublewords, 
or fields as data types. Some rules concerning storage addressing are: 


e All instructions must start on an even byte boundary. The effective address for all 

_ branching instructions must be on an even byte boundary. 

e All word and doubleword operand addresses must be on an even byte boundary. 

e In the case of indirect addressing, the address operand must be on an even byte 
boundary. 

e A stack control block must be on an even byte boundary. 

e All byte, word, and doubleword operand addresses point to the leftmost byte in the 
operand. 

e All bit and field addresses are specified by a byte address and a bit displacement, and 
point to the leftmost bit in a field. 


e In order to provide maximum addressing range, some instructions refer to an even byte 
displacement that is added to the contents of a register. In these cases, the register 
must also contain an even byte address to point to a word or doubleword operand. 

If one of the above rules is violated, a program check interrupt occurs with specification 
check set in the PSW. The instruction is suppressed. 


EFFECTIVE ADDRESS GENERATION 
For purposes of storage efficiency, certain instructions formulate storage operand 
addresses in a specialized manner. These instructions have self-contained fields that the 
assembler uses when generating effective addresses. Standard methods for deriving 


effective addresses are described in this section. 


Base Register, Word Displacement Short 
Instruction format: 


0 4 8 9 11 15 
— ae a 


Base register | 


00 register 0 
01 register 1 
10 register 2 
11 register 3 


Word displacement 
range 0 - 31 (decimal) 


The 5-bit unsigned integer (word disp) is doubled in magnitude to form a byte 
displacement, then is added to the contents of the specified base register to form the 


effective address. 


Example: 
op code RB word disp 
0 1 00100 
0 4 8 9 11 15 
(HEX) 
Contents of register 1 (RB) 0000 0000 0110 0000 0060 
Word displacement doubled 3. 0 1000 8 
Effective address 0000 0000 0110 1000 0068 


This is coded as shortaddr in the MVWS instruction. 
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Instruction format: 


Sr a 


0 4 5 7 8 15 
ee ao 


Base register | 


000 register 0 
001 register 1 
010 register 2 
011 register 3 
100 register 4 
101 register 5 
110 register 6 
111 register 7 


Word displacement 
range +127 to —128 (decimal) 


The 8-bit signed integer (word disp) is doubled in magnitude to form a byte displacement, 
then is added to the contents of the specified base register to form the effective address. 
The word displacement can be either positive or negative; bit 8 of the instruction word is 
the sign bit for the displacement value. If this high-order bit of the displacement field is a 
0, the displacement is positive with a maximum value of +127 (decimal). If the high-order 
bit of the displacement field is a 1, the displacement is negative with a maximum value of 
—128. A negative displacement is represented in twos complement form. 


Example: 


op code RB word disp 
11 0;1 110310021 


0 4 5 7 8 15 


Note: This example shows a negative word displacement (—17 hex) 
shown in twos complement. 


(HEX) 
Contents of register 6 (RB) 0000 0000 1000 0110 0086 
Word displacement doubled 
(Sign bit is propagated left) + 1111 111111010010 — 28 
Effective address 0000 0000 0101 1000 0058 


This is coded as (reg,jdisp) in the BXS instruction. 


Four-bit Address Argument 


Instruction format: 


0 4 8 9 1011 12 15 
ad 


Base register | 


00 register 0 
(AM = 00 or AM = 01) 
00 no register 
(AM = 10 or AM = 11) 
01 register 1 
10 register 2 
11 register 3 





Address mode 


The address mode has the following significance: 


AM=00. The contents of the base register form the effective address. The equivalent 
assembler instruction operand format is (reg®-? }, 


AM=01. The contents of the selected base register form the effective address. After use, 
the base register contents are increased by the number of bytes in the operand. 

For certain instructions (SELB, CPLB, LMB, STM, PB, PD, PW, PSB, PSD, and PSW) 
the effective address does not point to an operand, but to a control block or other system 
parameters. For these instructions, the contents of the specified register are increased by 
two. 


Example: 
op code RB | AM 
0 1/0 1 
0 4 8 9 1011 12 15 
Effective address (HEX) 


(Contents of register 1) 0000 0000 1000 0000 0080 


Contents of register 1 
after instruction execution 
Byte operand 0000 0000 1000 0001 0081 
Word operand 0000 0000 1000 0010 0082 
Doubleword operand 0000 0000 1000 0100 0084 


The equivalent assembler instruction operand format is (reg®? )+. 


AM=10. An additional word is appended to the instruction. The word has the following 
format. 


16 31 
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e If RB is zero, the appended word contains the effective address. 
e If RB is not zero, the contents of the selected base register and the contents of the 
appended word are added to form the effective address. 


Example: 
op code RB | AM address 
1 171 0 0000000100000 0 0 0 

0 4 8 9 1011 12 15 16 31 
(HEX) 

Contents of register 3 0000 1000 0000 0000 0800 

Contents of appended word +0000 0001 0000 0000 0100 

Effective address 0000 1001 0000 0000 0900 


The equivalent assembler instruction operand formats are addr and ( reg! > waddr). 


AM=11. An additional word is appended to the instruction. 
e If RB is zero, the appended word has the format: 


indirect address 


16 31 


This address points to a main storage location, on an even byte boundary, that 
contains the effective address. 


Example: 
op code RB | AM indirect address 
00 | 11 0000 0000 0101 0000 
0 4 8 9 1011 12 15 16 . 31 
(HEX) 
Contents of appended word 0000 0000 0101 0000 0050 


Effective address equals 
contents of storage at 
address 0050 (hexadecimal) 0000 0100 0000 00001 0400 


e If RB is not zero, the appended word has the format: 


16 23 24 31 


Five-bit Address Argument 


The two displacements are unsigned 8-bit integers. Displacement 2 is added to the 
contents of the selected base register to generate a main storage address. The contents 
of this storage location are added to displacement 1, resulting in the effective address. 





Example: 
op code RB | AM disp 1 disp2 
10 11 0010 0101 0100 0010 
910 1112 15 16 23 24 
(HEX) 
Contents of register 2 0000 0101 0011 0101 0535 
Displacement 2 a 0100 0010 42 
Storage address 0000 0101 O111 O111 0577 
Contents of storage at 0000 0100 0001 0000 0410 
address 0577 (Hexadecimal) 

Displacement 1 + 0010 0101 25 
Effective address 0000 0100 0011 0101 0435 


The equivalent assembler instruction operand formats are: 


dispI(reg'~*, disp2)* 
disp(reg'~> )* 

(reg? )* 
(reg'~3,disp)* 


Instruction format: 


Nal Ka 


0 4 5 7 10 11 12 15 
a ee an Vaan 
Base register | 
000 register 0 


(AM = 00 or AM = 01) 
000 no register 

(AM = 10 or AM= 11) 
001 register 1 
010 register 2 
011 register 3 
100 register 4 
101 register 5 
110 register 6 
111 register 7 





Address mode 
Operation of this mode is identical to the four-bit argument, but provides additional base 


registers. 
This is coded as addr 5. 
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Base Register, Storage Address 
Instruction format: 


0 4 8 


10 11 12 15°16 31° 


a 
Base register | 


000 no register 

001 register 1 

010 register 2 

011 register 3 0 = direct 
100 register 4 1 = indirect 
101 register 5 

110 register 6 

111 register 7 


e If RB is zero, the address field contains the effective address. 
e If RB is not zero, the contents of the selected base register and the contents of the 
address field are added together to form the effective address. 


Note. Bit 11, if a one, specifies that the effective addressing is indirect. 


Example: 
op code RB indirect address 
1 0 Of1 0000010000010 0 0 0 

0 4 8 10 11 12 15 16 31 
(HEX) 

Contents of register 4 0000 0001 0000 0000 0100 

Address field + 0000 0100 0001 0000 0410 

Storage address 0000 0101 0001 0000 0510 


Effective address 
Contents of storage at 
address 0510 (hexadecimal) 0000 0110 0100 0000 0640 


This is coded as Jongaddr. 


Instruction Length Variations for Address Arguments 

e One-word instructions that contain a single AM field become two words in length if 
AM is equal to 10 or 11. The appended word follows the instruction word. 

e Two-word instructions that contain a single AM field become three words in length if 
AM is equal to 10 or 11. The AM word is appended to the first instruction word. The 
data or immediate field then becomes the third word of the instruction. 

e One-word instructions that contain two AM fields (AMI and AM2) are one, two, or 
three words in length depending on the values of AM1 and AM2. The AMI word is 
appended first, then the AM2 word. 


Examples: 
e AM1=00 or AM1=01; AM2=00 or AM2=01 


| instruction word | no appended word 


0 15 
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¢ AMi=10 or AM1=11; AM2=00 or AM2=01 


0 15 16 | 31 


@e AM1=00 or AM1=01; AM2=10 or AM2=11 


0 15 16 31 


e AM1=10 or AM1=11; AM2=10 or AM2=11 


AM1 appended word AM2 appended word 


0 15 16 31 32 47 


THE PRIORITY INTERRUPT STRUCTURE 


The processor has four preemptive priority interrupt levels. Associated with each level is a 
bank of general registers and status registers. Each bank consists of eight general registers 
(RO—R7), a Level Status Register (LSR), an Instruction Address Register (I[AR), and an 
Address Key Register (AKR) (4955 Processor only). When switching between levels, the 
hardware automatically preserves the information contained in the interrupted-from level. 

The processor uses the device address to find the service routine for a given device; thus, 
there are 256 direct interrupt entry points. The IO instruction (prepare command) assigns 
an interrupt level to an I/O device. 

The processor enters supervisor state when it has accepted all priority interrupts. When 
the processor accepts an interrupt on a given level, that level remains active until a level 
exit (LEX) instruction is executed. If a higher-priority interrupt is accepted before the 
LEX is executed, the processor switches to the higher level, completes execution 
(including a LEX) and automatically returns to the interrupted-from level, provided no 
other higher priority interrupts are pending. If an interrupt is pending on the currently 
active level, it is not accepted until the LEX has been executed. When no levels are active, 
and no interrupts are pending, the processor enters the wait state. 


I/O STATUS 
I/O status is reported by: 


e Condition code 

e Interrupt Information Byte (IIB) 

© Device-dependent status words 

Condition codes are reported to the processor by the I/O device and/or the channel 
during the execution of every IO instruction and upon acceptance of every priority 
interrupt. 
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When an J/O interrupt is accepted, the device address and Interrupt Information Byte 
(IIB) are placed in register 7 of the interrupt-to level. The IIB contains eight bits of device 
status information that cannot be indicated to the program through condition codes. The 
value of the condition code determines the contents of the IIB. For cc=0, the IIB is 0. 
For cc=2 or 6, the IIB is referred to as the Interrupt Status Byte (ISB) and has two fixed 
formats—one for direct-program-control devices and one for cycle-steal devices. See 
Appendix K for these formats. For all other values of the condition code the contents of 
the IIB are device-dependent. 

Device-dependent status words are issued only by those devices that require more than 
the 8-bit IIB for complete status reporting. | 


The processor has three types of priority interrupt masking: 
e Summary mask 

e Interrupt level mask register 

e Device mask 


When disabled, the summary mask inhibits all priority interrupts on all levels. The 

contents of the interrupt level mask register are not changed. The summary mask is 

disabled by: 

e Execution of the SVC instruction 

e Execution of the Disable (DIS) instruction, with bit 15 a one 

e Acceptance of a machine check, soft exception, program check, power/thermal 
warning, supervisor call, console interrupt, or trace interrupt 

e Execution of set level status block (SELB) instruction with bit 11 of LSR to be loaded 
with zero 

The summary mask is enabled by: 

e Execution of the Enable (EN) instruction, with bit 15 a one 

e System reset, power-on reset, or IPL 

e Execution of Set Level Status Block (SELB) instruction with bit 11 of LSR to be 
loaded with one 

e Acceptance of a priority interrupt on the interrupted-to level 


When the summary mask is enabled, the summary mask bit in the LSR is equal to one. 


The Interrupt Mask Register (IMR) has a 1-bit mask for each interrupt level. When a bit is 
set to one, the level for that bit is enabled and permits an interrupt on that level. When a 
bit is set to zero, the corresponding level is disabled. The interrupt level mask register is 
changed by the Set Interrupt Mask Register (SEIMR) instruction and copied by the Copy 
Interrupt Mask Register (CPIMR) instruction. 


Each interrupting device contains a 1-bit device mask. When the mask is set to 1, the 
device can interrupt. The device mask is changed by the IO instruction (prepare 
command). 


CLASS INTERRUPTS 


Program Check 


Trace 


A class interrupt alerts the system to an error or exception condition. In addition, it gives 
the software a means for identifying the nature of the error or exception. The system can 
then recover, while normal processing continues with little disruption. The trace, soft 
exception trap, console, and supervisor call class interrupts are not errors; they are 
program-controlled exception conditions. 

The occurrence of a class interrupt does not change the priority level of the active 
software; however, an LSB is stored using the appropriate class interrupt pointer, the 
processor enters supervisor state, trace is reset, the summary mask is disabled, and the 
AKR is altered based on the type of class interrupt (4955 Processor only). If your 
processor has the optional full-function console, machine and program check class 
interrupts do not occur if check restart or stop on error are selected. 

The instruction address contained in the Level Status Block (LSB) for class interrupts 
depends on the type of class interrupt. For program check and soft exception, it is the 
address of the instruction that caused the class interrupt. For trace, supervisor 
call, power/thermal, and console, it is the address of the next instruction. For machine 
check, with the sequence indicator off, it is the address of the instruction that caused the 
class interrupt. For machine check, with the sequence indicator on, it is the address of the 
instruction in execution at the time of the error. | : 

Program check and trace interrupts are discussed next. For an explanation of the other 
class interrupts, refer to the processor description manual for your processor. See JBM 
4955 Processor and Processor Features Description, GA34-0021. 


A program check is caused only by software. If a program check interrupt occurs on one 
level, it does not affect software on other levels. A Level Status Block (LSB) is stored 
starting at the location in main storage designated by the contents of the program check 
LSB pointer (main. storage location OOOC hexadecimal). Then, the contents of the 
program check Starting Instruction Address (SIA) are loaded into the instruction address 
register, becoming the address of the next fetched instruction. 


An instruction trace facility is provided for software debugging. Instruction tracing can 
Occur On any interrupt level and is enabled by LSR bit 10, the trace bit. Instruction trace 
occurs whenever bit 10 of the current LSR is on. 

When trace is enabled, a trace class interrupt occurs at the beginning of each 
instruction. When the interrupt occurs, an LSB is stored, starting at the location in main 
storage designated by the contents of the trace LSB pointer (main storage location 0018 
hexadecimal). Then, the contents of the trace SIA (main storage location 001A 
hexadecimal) are loaded into the instruction address register, becoming the address of the 
next fetched instruction. 

After the LSB is stored, and before the next instruction is fetched, supervisor state is 
set on (LSR bit 8), trace is turned off (LSR bit 10) and the summary mask is disabled 
(LSR bit 11). 
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and Copy Level Status Block (CPLB) instructions. 


The Level Status Block (LSB) contains the IAR, registers 0 through 7, the Level Status 
Register (LSR), and the Address Key Register (AKR) (4955 Processor only) for the 
selected level. The format of the Level Status Block stored is: 


Main storage 
address 
(LSB pointer) 















Instruction address register 
Address key register * 


0 15 









+14 (Hex) 


*4955 Processor only 


The exact effect on the processor by the execution of the SELB instruction is determined 


by three factors: 
e The current execution level 


e The selected level as specified in the SELB instruction 


e The state of the in-process flag (bit 9 of the LSR) contained in the LSB specified by 


the effective address in the SELB instruction. 
The following table describes these conditions. 


Selected Level Lower Selected Level Equal 
Than Current Level To Current Level 


IN-PROCESS FLAG ON 


Causes selected level to be Causes selected level to 
pending with its LSB become the current with 
defined by the LSB at the its LSB defined by the 
EA. If no interrupts are LSB at the EA. 

being requested on a level 

higher than the selected 

level, execution of a LEX 

on the current level 

causes the selected level 

to become active. 


IN-PROCESS FLAG OFF 


Causes selected level to be Causes current level to 
not pending, with its LSB be excited in the manner 
defined by the LSB at described by the LEX 
the EA. instruction with the 

exception that its LSB 

is defined by the LSB 

at the EA. 


Selected Level Higher 
Than Current Level 


Causes selected level to 
become the current level 
with its LSB defined by 

the LSB at the EA. This 
operation is an interrupt 

to the higher level, causing 
the lower level to be pending. 


Causes higher level’s LSB to 
be defined by the LSB at the 
EA. 





SUPERVISOR STATE 


Program-controlled level switching is not subject to the summary mask or the interrupt 
level mask. 


Supervisor state is entered when a Supervisor Call (SVC) instruction is executed. 

The contents of the IAR are increased by 2. The current LSB is stored. The new LSR is 

set as follows: 

e Summary mask disabled 

e Supervisor state turned on 

e Trace turned off 

The AKR (4955 Processor only) is set as follows: 

e Equate operand spaces is disabled. 

e Operand 1 key is set to the previous operand 2 key. 
e Operand 2 key and instruction space key are set to 0. 

The parameter field in the instruction is loaded into bits 8—15 of register 1. A branch is 
taken to the SVC Start Instruction Address. 

The following, which are called privileged instructions, can be executed while the 
processor is in supervisor state only. If they are fetched in problem state, a program check 
class interrupt occurs, and the privilege violate bit (bit 02) is set in the processor status 
word, 


Mnemonic Instruction 


CPIMR Copy interrupt mask register 

























































SEIMR Set interrupt mask register 
CPIPF Copy in-process flags 

CPPSR Copy processor status and reset 
CPSR* Copy segmentation register 
SESR* Set segmentation register 
CPSK* Copy storage key 

SESK* Set storage key 

CPLB Copy level status block 

SELB Set level status block 





Copy floating-point level status block 
Set floating-point level status block 
Enable 

Disable 

Diagnose 

Operate I/O 

Level exit 

Copy current level 

Interchange operand keys 

Set address key register 

Set instruction space key 

Set operandl key 

Set operand2 key 

Copy address key register 


CPFLB* 
















CPISK* Copy instruction space key 
CPOOK* Copy operand! key 
CPOTK* Copy operand2 key 
SECON Set console data lights 


CPCON Copy console data buffer 


*4955 Processor only 
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Supervisor state is also entered and the summary mask disabled when a console or class 
interrupt occurs. Initial Program Load (IPL) or the acceptance of an I/O interrupt causes 
the machine to enter supervisor state, but the summary mask is not disabled. Supervisor 
state is exited by a SELB instruction. 


Stacking is a simple efficient mechanism for enqueuing data and/or parameters. Basically, 
a stack is a LIFO queue. There are operations that push a data item or parameter into the 
stack and pop the top item from the stack. In addition, there are limit-checking facilities, 
which test for overflow and underflow of a stack area. 

Any contiguous area of storage can be defined as a stack. Each logical stack is defined 
by a stack control block in the following format: 

Word | Top element address (TEA) 

Word 2 _—- High limit address of stack (HLA) 

Word 3 Low limit address of stack (LLA) 

The size of the stack is equal to HLA minus LLA. When a stack is empty, the top element 
address is equal to the high limit address. The HLA must be greater than the LLA. 

When an item is pushed to the stack, the address value in the TEA is decreased and 
compared against the LLA. If it is less than the LLA, a stack overflow exists. Stack 
overflow causes a soft exception interrupt to occur, with stack exception set in the PSW. 
The TEA is unchanged. If the stack does not overflow, the TEA is updated and the data 
item is moved to the storage location defined by the TEA. 

When an item is popped from a stack, the TEA is compared against the HLA. If it is 
greater than or equal to the HLA, a stack underflow exists. Stack underflow causes a soft 
exception interrupt to occur, with the stack exception bit on in the PSW. If the stack 
does not underflow, the data item defined by the current TEA is moved to a specified 
register and the address value of the TEA is increased. 

Note. It is possible to pop data from beyond the stack boundary if the TEA is less than 
the HLA, and the operand size is greater than (HLA-TEA). 

Stack operations are register-to-storage for push, and storage-to-register for pop. Bytes, 
words, doublewords and register blocks can be stacked. You are responsible for ensuring 
that the TEA word of a stack control block contains an even byte address for word, 
doubleword, and register block operations. All stack control blocks must be aligned on a 
word boundary. 


A word stack can be used for subroutine linkage, as a method of saving/restoring caller 
status and allocating dynamic word areas. The STM/LMB instruction pair operate using a 
stack area. The STM instruction specifies: | 

e Stack control block address (A) 

e Limit register number (R) 

e Number of bytes to allocate as dynamic work area (N) 

Note. You code this value in bytes, then the assembler converts it to words for use by the 
hardware instruction. 


When STM is executed, the TEA value is decreased by the size of the area allocated on 
the stack before an overflow check is made. The size of that area is N, plus two bytes for 
each register saved, plus two bytes for the control word. The link register (R7) and 
register 0 through register R are saved sequentially in the stack area and the address of the 
dynamic work area is returned to you in register R. If R7 is specified, only R7 is stored. 
The value of R and N are also saved as an entry in the stack. When an LMB instruction is 
executed, these values (R, N) are retrieved from the stack and are used to control the 
reloading of registers and restoring the stack control pointer to its former status. The 
contents of R7 are then loaded into the IAR, returning to the calling routine. For 
example, if you want to store register 7, then registers 0 through R, in a stack defined by 
the stack control block at location A, and you want to allocate N bytes of dynamic work 
area: 


STM R,A,N 
this is how the stack is stored: 


Low Storage. 


ae | LA 








Unused stack area 







Stack Control Word 





Dynamic 
Work 


NY 0<N S 16382 bytes 
Area (if any) 












Previously 
Stacked 
Data (if any) 


First word beyond stack 






———— HLA 





High Storage 
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Branch on Logically Greater Than (BLGT) 4-44 
Branch on Logically Greater Than or Equal (BLGE) 4-45 
Branch on Logically Less Than (BLLT) 4-45 
Branch on Logically Less Than or Equal (BLLE) 4-46 
Branch on Negative (BN) 4-46 

Branch on No Carry (BNCY) 4-47 

Branch on Not Condition (BNC) 4-47 

Branch on Not Condition Code (BNCC) 4-48 
Branch on Not Equal (BNE) 4-49 

Branch on Not Error (BNER) 4-49 

Branch on Not Even (BNEV) 4-49 

Branch on Not Negative (BNN) 4-50 

Branch on Not Overflow (BNOV) 4-50 
Branch on Not Positive (BNP) 4-51 

Branch on Not Zero (BNZ) 4-51 

Branch on Overflow (BOV) 4-52 

Branch on Positive (BP) 4-52 

Branch on Zero (BZ) 4-53 

No Operation (NOP) 4-53 

Coding Jump Instructions 4-54 

Jump and Link (JAL) 4-54 

Jump if Mixed (JMIX) 4-55 

Jump If Not Mixed (JNMIX) 4-55 

Jump if Not Off (JNOFF) 4-56 

Jump if Not On (JNON) 4-56 

Jump if Off JOFF) 4-57 

Jump if On (JON) 4-57 

Jump on Carry (JCY) 4-58 

Jump on Condition (JC) 4-58 

Jump on Count (JCT) 4-59 

Jump on Equal (JE) 4-60 

Jump on Even (JEV) 4-60 

Jump on Greater Than (JGT) 4-61 

Jump on Greater Than or Equal (JGE) 4-61 
Jump on Less Than (JLT) 4-62 

Jump on Less Than or Equal (JLE) 4-62 
Jump on Logically Greater Than (JLGT) 4-63 
Jump on Logically Greater Than or Equal (JLGE) 4-63 
Jump on Logically Less Than (JLLT) 4-64 
Jump on Logically Less Than or Equal (JLLE) 4-65 
Jump on Negative (JN) 4-65 

Jump on No Carry (INCY) 4-66 

Jump on Not Condition (INC) 4-66 

Jump on Not Equal (JNE) 4-67 

Jump on Not Even (JNEV) 4-67 

Jump on Not Negative (JNN) 4-68 

Jump on Not Positive (INP) 4-68 

Jump on Not Zero (JNZ) 4-69 

Jump on Positive (JP) 4-69 

Jump on Zero (JZ) 4-70 


Shift Instructions 4-71 


Coding Shift Instructions 4-71 
Shift Left Circular (SLC) 4-71 
Shift Left Circular Double (SLCD) 4-72 
Shift Left Logical (SLL) 4-72 
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Shift Left Logical Double (SLLD) 4-73 
Shift Left and Test (SLT) 4-74 
Shift Left and Test Double (SLTD) 4-75 
Shift Right Arithmetic (SRA) 4-76 
Shift Right Arithmetic Double (SRAD) 4-76 
_ Shift Right Logical (SRL) 4-77 

Shift Right Logical Double (SRLD) 4-78 


Stack Instructions 4-79 


Store Multiple (STM) 4-79 

Load Multiple and Branch (LMB) 4-80 
Coding Pop/Push Instructions 4-80 
Pop Byte (PB) 4-80 

Pop Doubleword (PD) 4-81 

Pop Word (PW) 4-82 

Push Byte (PSB) 4-82 

Push Doubleword (PSD) 4-83 

Push Word (PSW) 4-83 


Compare Instructions 4-84 


Using Compare Instructions 4-84 

Compare Byte (CB) 4-85 

Compare Byte Field Equal and Decrement (CFED) 4-85 
Compare Byte Field Equal and Increment (CFEN) 4-87 
Compare Byte Field Not Equal 

and Decrement (CFNED) 4-88 

Compare Byte Field Not Equal 

and Increment (CFNEN) 4-89 

Compare Byte Immediate (CBI) 4-90 

Compare Doubleword (CD) 4-91 

Compare Word (CW) 4-91 

Compare Word Immediate (CWI) 4-92 

Scan Byte Field Equal and Decrement (SFED) 4-92 
Scan Byte Field Equal and Increment (SFEN) 4-93 


Supervisor Call (SVC) 4-110 
Privileged Instructions 4-111 
Copy Address Key Register (CPAKR) 
(4955 Processor only) 4-111 
Copy Console Data Buffer (CPCON) 4-111 
Copy Current Level (CPCL) 4-112 
Copy In-Process Flags (CPIPF) 4-112 
Copy Instruction Space Key (CPISK) 
(4955 Processor only) 4-113 
Copy Interrupt Mask Register (CPIMR) 4-113 
Copy Level Status Block (CPLB) 4-114 


Copy Operand1 Key (CPOOK) (4955 Processor only) 4-115 
Copy Operand2 Key (CPOTK) (4955 Processor only) 4-116 


Copy Processor Status and Reset (CPPSR) 4-116 
Copy Segmentation Register (CPSR) 

(4955 Processor only) 4-117 
Copy Storage Key (CPSK) (4955 Processor only) 4-118 
Diagnose (DIAG) 4-118 

Disable (DIS) 4-119 

Enable (EN) 4-120 

Interchange Operand Keys (IOPK) 

(4955 Processor only) 4-120 

Level Exit (LEX) 4-121 

Operate 1/0 (IO) 4-121 

Set Address Key Register (SEAKR) 

(4955 Processor only) 4-122 

Set Console Data Lights (SECON) 4-122 
Set Instruction Space Key (SEISK) 

(4955 Processor only) 4-123 

Set Interrupt Mask Register (SEIMR) 4-123 
Set Level Status Block (SELB) 4-124 

Set Operand1] Key (SEOOK) 


Scan Byte Field Not Equal and Decrement (SFNED) 4-94 
Scan Byte Field Not Equal and Increment (SFNEN) 4-95 
Logical Instructions 4-96 


(4955 Processor only) 4-125 
Set Operand2 Key (SEOTK) 
(4955 Processor only) 4-126 


AND Word Immediate (NWI) 4-96 
Exclusive OR Byte (XB) 4-96 

Exclusive OR Doubleword (XD) 4-97 
Exclusive OR Word (XW) 4-98 

Exclusive OR Word Immediate (XWI) 4-98 
Invert Register (VR) 4-99 

OR Byte (OB) 4-100 

OR Doubleword (OD) 4-100 

OR Word (OW) 4-101 

OR Word Immediate (OWI) 4-102 

Reset Bits Byte (RBTB) 4-102 

Reset Bits Doubleword (RBTD) 4-103 
Reset Bits Word (RBTW) 4-104 

Reset Bits Word Immediate (RBTWI) 4-104 
Test Bit (TBT) 4-105 

Test Bit and Invert (TBTV) 4-106 

Test Bit and Reset (TBTR) 4-106 

Test Bit and Set (TBTS) 4-107 

Test Word Immediate (TWI) 4-108 


Processor Status Instructions 4-109 


Copy Level Status Register (CPLSR) 4-109 
Set Indicators (SEIND) 4-109 
Stop (STOP) 4-110 
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Set Segmentation Register (SESR) 

(4955 Processor only) 4-126 

Set Storage Key (SESK) (4955 Processor only) 4-127 
Floating-Point Instructions (4955 Processor only) 4-128 

Floating-point Number Representation 4-128 

Floating-point Registers and Instructions 4-130 

Copy Floating Level Block (CPFLB) 4-130 

Floating Add (FA) 4-130 

Floating Add Double (FAD) 4-131 

Floating Compare (FC) 4-132 

Floating Compare Double (FCD) 4-132 

Floating Diagnose (FDIAG) 4-133 

Floating Divide (FD) 4-133 

Floating Divide Double (FDD) 4-134 

Floating Move (FMV) 4-134 

Floating Move Double (FMVD) 4-135 

Floating Move and Convert (FMVC) 4-136 

Floating Move and Convert Double (FMVCD) 4-137 

Floating Multiply(FM) 4-138 

Floating Multiply Double (FMD) 4-138 

Floating Subtract (FS) 4-139 

Floating Subtract Double (FSD) 4-140 

Set Floating Level Block (SEFLB) 4-140 


CODING NOTES 


Hardware instructions are represented symbolically by assembler-language statements. 
Each statement generates one hardware instruction—the actual instruction generated 
depends on the operation code and the syntax of the operand. 

Each mnemonic operation code specifies the function of an instruction and the type of 
data it operates on. For example, the Move Word (MVW) instruction moves (MV) a word 
(W) from a register to storage, storage to a register, storage to storage, or a register to a 
register, depending on the operands you code. Based on the syntax of the operands, the 
assembler generates one of several possible hardware instructions. If more than one 
hardware instruction can perform the operation specified by the mnemonic and its 
operand, the assembler generates the one that is most efficient in timing and storage 
usage. 

This chapter discusses the assembler-language machine instructions—how you code 
them and what they do. 


e Data flow, when it modifies a field, is always from left to right. 

e Registers used in effective address calculations are always in parentheses. 

e An address specification followed by an asterisk indicates indirect addressing. Here, 
the effective address is the contents of the addressed storage location. 

e The (reg/+ format indicates that, after use, the contents of the reg are increased by the 
number of bytes addressed. 
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CODING THE ASSEMBLER LANGUAGE INSTRUCTIONS 

This section explains the symbols that are used as generalized operands in the discussion 
of machine instructions. (The discussion of machine instructions comprises the remainder 
of this chapter.) 
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abcnt 


addr 


addr4 


addr5 


An absolute value or expression representing the size of a work storage 
area to be allocated by the Store Multiple (STM) instruction. The value 
you code must be an even number in the range O—16382. 


An address value. Code an absolute or relocatable expression in the range 
0-—-65535. 


An address value that you code in one of the following forms: 


(reg) 


The effective address is the contents of the register 
reg? >, 

(reg *)+ The effective address is the contents of the register 
reg’>. After an instruction uses it, the contents of 
the register are increased by the number of bytes 


addressed by the instruction. 


addr _ The effective address is the value of addr, unless the 
instruction and addr are within the domain and range 
of the same USING statement. If they are, the 
assembler computes the effective address as a 
displacement (—32768 to +32767 or 0 to 65535) 
from the base register, which must be reg'”°. 

addr* The effective address is the contents of storage at the 
address defined by addr, unless the instruction and 
addr are within the domain and range of the same 
USING statement. If they are, the assembler 
computes the effective address as the contents of 
storage at the address defined by a displacement 
(O—255) from the base register, which must be 
regi3, 

(reg'~3 wwaddr) The effective address is the contents of the register 
reg'~>, added to the value of wadar. 

disp1(reg!~* ,disp2)* The effective address is calculated as follows: The 
contents of the register reg'° are added to the value 
of the displacement disp2 to form an address. The 
contents of that storage location are added to the 

| value of disp] to form the effective address. 

disp(reg’ °)* The effective address is the contents of storage at the 
address defined by the contents of reg’-* added to 
the value of disp. 


(reg'3)* The effective address is the contents of storage at the 
address defined by the contents of reg!~3. 
(reg? disp)* The contents of reg!~> are added to disp, forming an 


address. The contents of storage at that address form 
the effective address. 

For the byte addressing, the effective address can be even or odd. For 

word or doubleword addressing, the effective address must be even. 

An address value that you code in one of the following forms: 

(reg) The effective address is the contents of the register 
reg. 


bitdisp 
byte 
cntl6 
ent31 
cond 
disp 


freg 


jaddr 


(reg)+ The effective address is the contents of the register 
reg. After an instruction uses it, the contents of the 
register are increased by the number of bytes 
addressed by the instruction. 


addr The effective address is the value of addr, unless the 
instruction and addr are within the domain and range 
of the same USING statement. If they are, the 
assembler computes the effective address as a 
displacement (—32768 to +32767 or 0 to 65535) 
from the base register, which must be reg!~’. 

addr™ The effective address is the contents of storage at the 
address defined by addr, unless the instruction and 
addr are within the domain and range of the same 
USING statement. If they are, the assembler 
computes the effective address as the contents of 
storage at the address defined by a displacement 
(0O—255) from the base register, which must be 
reg”. 

(reg'~7 waddr) The effective address is the contents of reg'~” ,added 
to the value of waddr. 

displ(reg!~7 disp2)* The effective address is calculated as 
follows: contents of the register reg'~’ are added to 
the value of the displacement disp2 to form an 
address. The contents of that storage location are 
added to the value of disp] to form the effective 
address. 

disp(reg’"7)* The effective address is the contents of storage at the 
address defined by the contents of reg'’, added to 
the value of disp. 


(reg'~7)* The effective address is the contents of storage at the 
address defined by the contents of reg'~’. 

(reg'~7 ,disp)* The contents of reg'~” are added to disp, forming an 

address. The contents of storage at that address form 


the effective address. 
For byte addressing, the effective address can be even or odd. For word or 
doubleword addressing, the effective address must be even. 
A displacement into a bit field. Code an absolute value or expression in the 
range 0—63. 
A byte value. Code an absolute value or expression in the range —128 to 
+127 or 0 to 255. 
A single word (one register) shift count. Code an absolute value or 
expression in the range 0-16. 
A doubleword (register pair) shift count. Code an absolute value or 
expression in the range 0-31. 
A condition code value. Code an absolute value or expression in the range 
0-7. 
A byte address displacement. Code an absolute value or expression in the 
range 0—255. 
A floating-point register. Code either a predefined floating register symbol 
(FRO—FR3) or a symbol that is equated to the desired register number (0, 
1, 2, or 3). Symbols are equated with EQUR statements, which must 
precede the instruction using the register symbol. 
The address of an instruction that is within —256 to +254 bytes of the 
byte following a jump instruction. Code a relocatable expression. 
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jdisp 


longaddr 


raddr 
reg 


ubyte 
vcon 

waddr 
wdisp 


word 


A byte address displacement. Code an even absolute value or expression in. 

the range —256 to +254. 

An address value that you code in one of the following forms: 

addr The effective address is the value of addr, unless the 
instruction and addr are within the range of the same 
USING statement. If they are, the assembler 
computes the effective address as a displacement 
(-—32768 to +32767 or 0 to 65535) from the base 
register, which must be reg’~”. 


addr* The effective address is the contents of storage at the 
address defined by addr, unless the instruction and 
addr are within the range of the same USING 
statement. If they are, the assembler computes the 
effective address as the contents of storage at the 
address defined by a displacement (—32768 to 
+32767 or 0 to 65535) from the base register, which 
must be reg'”’. 
The effective address is the contents of reg!’ , added 
to the value of wadadr. 
(reg'~7 waddr)* The contents of reg'”’, plus waddr, form an address. 
The contents of storage at that location form the 
effective address. 


(reg’~’ , waddr) 


(reg’”) The effective address is the contents of the register 
reg'””, 
(reg’"7)* The effective address is the contents of storage at the 


address defined by the contents of reg’”’. 
An address value. Code a relocatable expression in the range O—63535. 
A general-purpose register. Code either a predefined register symbol 
(RO—R7) or a symbol that is equated to the desired register number (0, 1, 
2, 3, 4, 5, 6, or 7). Symbols are equated with EQUR statements, which 
must precede the instruction using the register symbol. 
A general-purpose register. Code either a predefined register symbol 
(RO—R3) or a symbol that is equated to the desired register number (0, 1, 
2, or 3). Symbols are equated with EQUR statements, which must precede 
the instruction using the register symbol. 
A general-purpose register. Code either a predefined register symbol 
(R1—R3) or a symbol that is equated to the desired register number (1, 2, 
or 3). Symbols are equated with EQUR statements, which must precede 
the instruction using the register symbol. 
A general-purpose register. Code either a predefined register symbol 
(R1—R7) or a symbol that is equated to the desired register number (1, 2, 
3, 4, 5, 6, or 7). Symbols are equated with EQUR statements, which must 
precede the instructions using the register symbol. 
An unsigned byte value or mask. Code an absolute value or expression in 
the range Q—255. 


An ordinary symbol that is defined externally from the current source 
program. 

A one-word address value. Code an absolute or relocatable expression in 
the range —32768 to +32767 or 0 to 65535. 

An even byte address displacement. Code an absolute value or expression 
in the range 0—62. 

A word value. Code an absolute value or expression in the range —32768 to 
+32767 or 0 to 65535. 


DATA MOVEMENT INSTRUCTIONS 
Fill Byte Field and Decrement (FFD) 


Indicators 


FFD Example 


This instruction fills a field in storage, right-to-left, with a byte from a register. 


Here is how to use FFD: 


1. Before FFD, code an instruction to load register 7 with the size (in bytes) of the 
destination field. Note that this is an unsigned value. 
2. For reg, code the register from which the byte is moved. 
3. For (reg), code the address of the rightmost byte of the destination field. 
Here is what FFD does: 


1. It moves bits 8—15 of reg to the rightmost byte of the (reg) field. 

2. It then moves the same byte from reg to the byte (in the (reg) field) to the left of the 
preceding byte. 

3. It proceeds to the left, moving one byte at a time from reg to (reg), until it has moved 
the number of bytes specified by register 7. 


When FFD is finished, register 7 contains 0, reg is unchanged, and (reg) contains the 


address of the byte before the leftmost byte in the field. That is, if the leftmost byte is 
0207, (reg) points to 0206. 









The carry and overflow indicators are unchanged. The remaining indicators reflect the last 
byte moved. 


FFD RS,(R6) 


Assume that: 

e Register 7 contains X‘0003’—the number of bytes to be moved, 

e Register 5 contains X°34A7’, and 

e Register 6 contains X‘0300’—the address of the rightmost byte in the destination field. 
As Figure 4-1 shows, FFD moves the value A7 into: 

(1) Byte 0300, 

(2) Byte 02FF, then 

(3) Byte O2FE. 
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Coding Hint 


Register 5 
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02FD 02FE 02FF 0300 


Figure 4-1. FFD example. 


After FFD: 


e Register 7 contains 0, 
e Register 5 contains X°34A7’, and 
e Register 6 contains X‘02FD’. 


Use this instruction when you want to clear an area—that is, fill it with blanks or zeros. 


Fill Byte Field and Increment (FFN) 


Indicators 


FFN Example 
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This instruction fills a field in storage, left-to-right, with a byte from a register. 


reg, (reg) 





Code FFN like FFD, with one difference. For (reg), code the address of the leftmost 
byte of the destination field. 


FFN does the same thing as FFD, with one exception. The reg byte moves to the 
leftmost byte of the (reg) field, and proceeds to the right. 


When FEN is finished, register 7 contains 0, reg is unchanged, and (reg) contains the 


address of the byte following the rightmost byte in the field. That is, if the rightmost 
byte is 010B, (reg) points to 010C. 


The carry and overflow indicators are unchanged. The remaining indicators reflect the last 
byte moved. 


FFN R5,(R6) 


Assume that: 


e Register 7 contains X‘0003’—the number of bytes to be moved, 
e Register 5 contains X°34A7’, and 


e Register 6 contains X‘0600’—the address of the leftmost byte in the destination field. 


Coding Hint 


Interchange Registers (IR) 


Indicators 


IR Example 


As Figure 4-2 shows, FFN moves the value A7 into: 


(1) Byte 0600, 
(2) Byte 0601, then 
(3) Byte 0602. 


Register 5S 








0600 0601 0602 0603 
Figure 4-2. FFN example. 


After FFN: 


e Register 7 contains 0, 
e Register 5 contains X°34A7’, and 
e Register 6 contains X‘0603’. 


Use this instruction when you want to clear an area—that is, fill it with blanks or zeros. 


This instruction interchanges the contents of two registers. 


ee a ee 


The indicators are set to reflect the new contents of the register defined by the second 
operand. 





IR R4,RI 


Assume that register 4 contains X‘1234’ and register 1 contains X‘5678’. After IR, 
register 4 coritains X°5678’ and register 1 contains X‘1234’. 
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Move Address (MVA) 


Indicators 


MVA Example 


Move Byte (MVB) 


Indicators 
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This instruction places an effective address into a register or a storage location. 


addr4, reg 
raddr, addr4 








[label] MVA 


Note. The addr or addr* form of the first operand must be coded as a relocatable 
expression. 


The carry and overflow indicators are unchanged. The remaining indicators reflect the 
new contents of the second operand. : 


MVA LOCI,R3 


This instruction loads the address of LOC] into register 3. 


This instruction moves one byte from a register to storage, from storage to a register, or 
from storage to storage. 





reg, addr4 
[label] MVB addr4, reg 
addr5, addr4 


e In the register-to-storage format, bits 8—15 of reg are moved to addr4. 

e In the storage-to-register format, the byte is moved from addr4 to bits 8—15 of the 
register. The high-order bit of the moved byte is propagated through bits 0—7 of reg. 

e In the storage-to-storage format, the byte moves from addrS to addr4. 


The carry and overflow indicators are unchanged. The remaining indicators reflect the 
byte moved. 


MVB Examples 


Move Byte and Zero (MVBZ) 


Indicators 


MVBZ Example 


MVB R3,(R2) 


Bits 8—15 of register 3 are moved to the storage location whose address is in register 2. 


MVB 6(R3,4)*,R5 


e The contents of register 3, plus 4, form an address. 

e The contents of that storage location, plus 6, form the address of the byte to be 
moved. 

e MVB moves the byte to bits 8—15 of register 5. 

e If the high-order bit of the moved byte is 0, bits O—7 of register 5 contain zeros; if the 
high-order bit is 1, bits O—7 contain ones. 


MVB THERE ,HERE+] 


The first byte of storage location THERE is moved to one byte past storage location 
HERE. 


This instruction moves a byte from storage to a register, then replaces the byte in storage 
with zeros. 


MVBZ moves a byte from addr4 to bits 8—15 of reg. The high-order bit of the moved 
byte is propagated through bits O~—7 of the register. 
After the move, the byte at addr4 is filled with zeros. 









The carry and overflow indicators are unchanged. The remaining indicators reflect the 
moved byte. 


MVBZ LOC4,R3 


MVBZ moves the contents of the byte at LOC4 to bits 8—15 of register 3, and propagates 
the high-order bit of the byte through bits O—7 of the register. After MVBZ executes, 
LOC4 contains zeros. 
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Move Byte Field and Decrement (MVFD) 


Indicators 


MVFD Example 


4-12 


SC34-0074 


This instruction moves a specified number of bytes, one byte at a time, right-to-left, from 
one storage location to another. 


- ™ 


MVFD moves a field between two storage locations. For (reg),(reg) code the registers 
that contain the addresses of the rightmost bytes of the source and destination fields. 
MVFD assumes that you have loaded register 7 with an unsigned number—the number 
of bytes to be moved. If R7 contains zero, this instruction is treated as a no-operation. 
After MVFD: 
e Register 7 contains 0, 
e The first operand points to the byte before the leftmost byte in the source field, and 
e The second operand points to the byte before the leftmost byte in the destination 
field. 









The carry and overflow indicators are unchanged. The remaining indicators reflect the last 
byte moved. 


MVFD (RS), (R6) 


Assume that: 


e Register 5 contains X‘0200’, 
e Register 6 contains X‘0300’, and 
e Register 7 contains X‘0003’. 

The address of the rightmost byte of the source field is 0200, and 0300 is the address of 
the rightmost byte of the destination field. As Figure 4-3 shows, MVFD moves 3 bytes: 
(1) Byte 0200 to byte 0300, 

(2) Byte O1FF to byte 02FF, and 
(3) Byte O1FE to byte 02FE. 


SOURCE 


Byte O1FE | Byte O1FF | Byte 0200 





Byte O2FE | Byte O2FF | Byte 0300 





DESTINATION 


Figure 4-3. MVEFD example. 


When MVED is finished: 
e Register 7 contains X*0000’, 
e Register 5 contains X‘O1FD’, and 
e Register 6 contains X‘O2FD’. 


Move Byte Field and Increment (MVFN) 


This instruction moves a specified number of bytes, left-to-right, from one storage 
location to another. 


MVEN moves a field between two storage locations. For (reg),/reg) code the registers 
that contain the addresses of the leftmost bytes of the source and destination fields. 
MVEN assumes that you have loaded register 7 with an unsigned number—the number 
of bytes to be moved. If R7 contains zero, this instruction is treated as a no-operation. 
After MVEN: 


e Register 7 contains 0, 

e The first operand points to the byte after the rightmost byte in the source field, and 

e The second operand points to the byte after the rightmost byte in the destination 
field. 





Indicators 


The carry and overflow indicators are unchanged. The remaining indicators reflect the last 
byte moved. 
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MVEN Example 


MVEN (R5) , (R6) 


Assume that: 

e Register 5 contains X‘0200’, 

e Register 6 contains X°0300’, and 
e Register 7 contains X‘0003’. 


_ The address of the leftmost byte of the source field is 0200, and 0300 is the address of 
the leftmost byte of the destination field. As Figure 4-4 shows, MVFN moves 3 bytes: 


(1) Byte 0200 to byte 0300, 
(2) Byte 0201 to byte 0301, and 
(3) Byte 0202 to byte 0302. 


SOURCE 











Byte 0202 








Byte 0200 | Byte 0201 


Byte 0300 | Byte 0301 | Byte 0302 
DESTINATION 





Figure 4-4. MVFN example. 


When MVEN is finished: 
e Register 7 contains X‘0000’, 
e Register 5 contains X‘0203’, and 
e Register 6 contains X‘0303’. 


Move Byte Immediate (MVBI) 


Indicators 
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This instruction places one byte of immediate data into a register. 


| Operation — 


byte, reg 


Operand 





For the byte operand, code an absolute value or expression, —128 to 127 or 0 to 25S. 
MVBI places this value into bits 8—15 of reg. The high-order bit of the byte value is 


propagated through bits O—7 of reg. 


The carry and overflow indicators are unchanged. The remaining indicators reflect the 


byte loaded into reg. 


MVBI Example 


Move Doubleword (MVD) 


Indicators 


MVD Examples 


MVBI =3,R6 


This instruction places —3 into bits 8—15 of register 6. Bits O—7 contain ones. 


This instruction moves a doubleword (4 bytes): 
e From a register pair to storage, 

e From storage to a register pair, or 

e From storage to storage. 


reg, addr4 
addr4, reg 
addr5, addr4 












[label] 


For the register-to-storage syntax or the storage-to-register syntax, specify a storage 
address and the first register of a register pair. 

For the storage-to-storage syntax, specify the addresses of the source and destination of 
the doubleword. 


The carry and overflow indicators are unchanged. The remaining indicators reflect the 
doubleword moved into the second operand. 


MVD THERE ,HERE 


This instruction moves a doubleword from storage location THERE to storage location 
HERE. 


MVD R4, (R6) 


This instruction moves a doubleword—the contents of registers 4 and 5—to the storage 
location indicated by the contents of register 6. 


MVD LOC2,R7 


This instruction moves a doubleword from storage location LOC2 and places it in 
registers 7 and 0. 


Machine Instructions 4-15 


Move Doubleword and Zero (MVDZ) 


Indicators 


MVDZ Example 


Move Word (MVW) 


Indicators 


MVW Examples 
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This instruction moves a doubleword (4 bytes) from storage to a register pair, then 
replaces the doubleword in storage with zeros. 


When you code MVDZ, specify a storage address and the first register of a register pair. 
MVDZ moves a doubleword from addr4 to the register pair. 
After the move, the doubleword at addr4 is filled with zeros. 





The carry and overflow indicators are unchanged. The remaining indicators reflect the 
doubleword moved into the second operand. 


MVDZ (R2) ,R3 
This instruction moves a doubleword from the address in register 2 to registers 3 and 4. 
After the move, the doubleword whose address is in register 2 is filled with zeros. 


This instruction moves a word (2 bytes): 


e From a register to a register, 
e From a register to storage, 

e From storage to a register, or 
e From storage to storage. 


reg, reg 

reg, addr4 
addr4, reg 
longaddr, reg 
reg, longaddr 
addr5, addr4 















[label] MVW 





The carry and overflow indicators are unchanged. The remaining indicators reflect the 
word moved into the second operand. 


MVW RI,R2 


This instruction (coded in reg,reg form) moves a word from register 1 to register 2. 


MVW (RI) ,R2 


This instruction (coded in addr4,reg form) moves a word from the storage location 
whose address is in register 1 to register 2. 


Note. This instruction is also a valid longaddr,reg form. The assembler generates the 
addr4,reg form because it is more efficient with respect to speed and storage usage. 


MW (R1) , (R2) 


This instruction (coded in addr5,addr4 form) moves a word from the storage location 
whose address is in register 1 to the storage location whose address is in register 2. 


Move Word and Zero (MVWZ) 


This instruction moves a word (2 bytes) from storage to a register, then fills the word in 
storage with zeros. 


The carry and overflow indicators are unchanged. The remaining indicators reflect the 
word moved into the second operand. 









Indicators 


MVWZ Example 


MVWZ (R2,DISP5) ,R6 


The address in register 2, plus the value of DISP5, form the address of the word to be 
moved. The word is moved to register 6. After the move, the word in storage is filled with 
Zeros, 


Move Word Immediate (MVWID 
This instruction moves a one-word (2-byte) absolute value to a storage location or register. 


d, addr4 


word, reg 
For the word operand, code an absolute value or expression between —32768 and 
65535. 










Indicators 
The carry and overflow indicators are unchanged. The remaining indicators reflect the 
word moved into the second operand. 
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MVWI Example 


Move Word Short (MVWS) 


Indicators 
4-18 SC34-0074 


WWI 3488, L0C3 


This instruction moves the value 3488 into the word at storage location LOC3. 


This instruction moves a word (2 bytes): 


e From a register to storage, or 


e From storage to a register. 








jana | ems 





reg, shortaddr 
shortaddr, reg 


The operand shortaddr is an address value that you code in one of the following forms: 


(reg? 3 ,wdisp) 


(reg?"3 wdisp)* 


(reg? *) 


(reg? °)* 


addr 


addr* 


The effective address is the value of wdisp added to 
the contents of reg°>. 


The effective address is the contents of storage at the 
address defined by the value of wdisp added to the 
contents of reg?"3. 

The effective address is the contents of (reg®-?). 


The effective address is the contents of storage at the 
address defined by the contents of reg*”>. 


To use this form, the instruction and addr must be in 
the domain and range of the same USING statement. 
The assembler computes a displacement (0O—62) and 
register combination that references the requested 
location. 

Same as addr, except the assembler computes the 
effective address as the contents of storage at the 
address defined by a displacement (O—62) and 
register combination. 


Note. For addr and addr*, the base register must be reg®°. 


The carry and overflow indicators are unchanged. The remaining indicators reflect the 
word moved into the second operand. 


MVWS Examples 


Coding Hints 


This instruction moves the contents of register 6 into the storage location whose address 
is in register 2. 


MWS (R3,24)*,R5 


e The contents of register 3, plus 24, form an address. 
e That storage location contains the address of the word to be moved into register 5. 
© MVWS moves this word into register 5. 


Use this instruction to move to or from an address that is either: 


e The contents of a register with no displacement, or 
e The contents of a register plus a displacement of 0 to 62. 


The advantage of using MVWS is that it requires only 2 bytes of storage. 
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ARITHMETIC INSTRUCTIONS 
Add Byte (AB) 


Indicators 


AB Examples 


Add Byte Immediate (ABI) 
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This instruction adds: 


e A byte in a register to a byte in storage, or 
e A byte in storage to a byte in a register. 


reg, addr4 
addr4, reg 





If you code the reg,addr4 form, bits 8—15 of reg are added to the byte at addr4. 
In the addr4,reg form, the byte at addr4 is added to bits 8—15 of reg. The high-order 
byte of reg remains unchanged. 


The overflow indicator is cleared. If the addition results in a sum that is less than —2’ or 
greater than +2’—1, the overflow indicator is turned on. 

The carry indicator is turned on if the addition results in a carry out of the high-order 
bit position of the byte (for a total of 9 bits in the sum). If there is no carry, the carry 
indicator is turned off. 

Also, if an overflow occurs, the carry indicator contains the sign bit, and the second 
operand contains the low-order 8 bits of the sum. 

The other indicators change to reflect the 8-bit result. 


AB VAL@1,R5 


Assume that VALOI contains X‘20’, and register 5 contains X‘2C83’. AB 
adds: 20+83=A3. VALO1 remains unchanged, and register 5 now contains X‘2CA3’. The 
carry indicator and overflow indicator are both off. 


- no vaLg2,R5 


Assume that VALO2 contains X‘30’, and register 5 contains X‘O8FE’. AB 
adds: 30+FE=12E. VALO2 remains unchanged, and register 5 now contains X‘082E’. 
The carry indicator is on and the overflow indicator is off. 


This instruction adds a 1-byte absolute value to a register. 


For byte, code an 8-bit value in the range of —128 to +127 or 0 to 255. ABI expands 
this value to 16 bits by propagating the sign bit to the left of the byte value. This value is 
then added to reg. 










Indicators 


_ ABI Example 


Add Carry Indicator (ACY) 


Indicators 


ACY Example 


Add Doubleword (AD) 


The overflow indicator is cleared. If the addition results in a sum that is less than —2!5 or 
greater than +2'°—1, the overflow indicator is turned on. 

The carry indicator is turned on if the addition results in a carry out of the high-order 
bit position of the register (for a total of 17 bits in the sum). If there is no carry, the 
carry indicator is turned off. 

Also, if an overflow occurs, the carry indicator contains the sign bit, and the register 
contains the low-order 16 bits of the sum. 

The other indicators change to reflect the 16-bit result. 


“ABI 34,R6_ 


Assume that R6 contains X‘0050’. ABI expands X‘22’ (the equivalent of decimal 34) to 
16 bits by propagating the sign bit (zero) to the left. ABI then 
adds: X‘0022’+X‘0050’=X‘0072’. R6 now contains X‘0072’ (decimal 114). 


This instruction adds the value of the carry indicator to a register. 


pom fm tm 


The overflow indicator is cleared. If the addition results in a sum that is less than —2'5 or 
greater than +2! °—1, the overflow indicator is turned on. 

The carry indicator is turned on if the addition results in a carry out of the high-order 
bit position of the register (for a total of 17 bits in the sum). If there is no carry, the 
carry indicator is turned off. 

Also, if an overflow occurs, the carry indicator contains the sign bit, and the register 
contains the low-order 16 bits of the sum. 

If the zero indicator is on at the beginning of this instruction, it is set to reflect the 
result; if it is off at the beginning, it stays off. The negative indicator reflects the sum, and 
the even indicator is unchanged. 









CACY RA 


Assume that register 4 contains X‘0027’, and the carry indicator is on. ACY adds 1 to the 
contents of R4, and the register now contains X‘0028’. 


This instruction adds: 


e A doubleword (4 bytes) in a register pair to a doubleword in storage, 
e A doubleword in storage to a doubleword in a register pair, or 
e A doubleword in storage to a doubleword in storage. 
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Indicators 


AD Example 


Add Word (AW) 
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reg, addr4 
addr4, reg 
addr5, addr4 


In either the register-to-storage form or the storage-to-register form, code—for the reg 
operand—the first register of a register pair. For example, if you code R5, AD uses 
registers 5 and 6. If you code R7, AD uses registers 7 and 0. 

AD adds the contents of the doubleword specified by the first operand to the contents 
of the doubleword specified by the second operand, placing its result in the second 
operand. The first operand remains unchanged. 


The overflow indicator is cleared. If the sum is less than —2?! or greater than +23’—1, the 
overflow indicator is turned on. | 

The carry indicator is turned on if the addition results in a carry out of the high-order 
bit position of the sum (for a total of 33 bits in the sum). If there is no carry, the carry 
indicator is turned off. 

Also, if an overflow occurs, the carry indicator contains the sign bit, and the register 
pair or doubleword in storage contains the low-order 32 bits of the sum. — 

The other indicators change to reflect the 32-bit result. 


AD RB, (RI) 


Assume that the register pair R3,R4 contains X‘25000000’, R1 contains X‘0300’, and the 
doubleword at storage address 0300 contains X°10000000’. AD 
adds: X‘25000000’+X‘10000000’=X‘35000000’. Registers 3 and 4 remain unchanged, 
and the doubleword at storage address 300 contains X°35000000’. 


This instruction adds: 

e A word (2 bytes) in a register to a word in a register, 
e A word in a register to a word in storage, 

e A word in storage to a word in a register, or 

e A word in storage to a word in storage. 










reg, reg 

reg, addr4 
[label ] AW addr4, reg 

longaddr, reg 

addr5, addr4 


AW adds the contents of the word specified by the first operand to the contents of the 
word specified by the second operand. The first operand remains unchanged. 


Indicators 


AW Example 


Add Word Immediate (A WI) 


Indicators 


AWI Example 


The overflow indicator is cleared. If the addition results in a sum that is less than —2'* or 
greater than +2'°—1, the overflow indicator is turned on. 

The carry indicator is turned on if the addition results in a carry out of the high-order 
bit position of the result operand (for a total of 17 bits in the sum). If there is no carry, 
the carry indicator is turned off. 

Also, if an overflow occurs, the carry indicator contains the sign bit, and the result 
operand contains the low-order 16 bits of the sum. 

The other indicators change to reflect the 16-bit result. 


$ ¢ F  & ¢ 


This instruction adds the word at storage location THERE to the word at the storage 
location whose address is in R2. 


This instruction adds a 1-word (2-byte) absolute value: 


e To a register, or 
e To the contents of a storage location. 





word, reg[,reg] 


For word, code a 16-bit value in the range —32768 to +32767 or 0 to 65535. AWI adds 
this value to the contents of the word specified by the second operand. 

In the word,reg|,reg| format there is an optional third operand. If you code a register 
for this operand, the result of the addition is placed in that register. If you do not code 
the third operand, AWI places the sum in the register specified by the second operand. 


The overflow indicator is cleared. If the addition results in a sum that is less than —2'* or 
greater than +2'*—1, the overflow indicator is turned on. 

The carry indicator is turned on if the addition results in a carry out of the high-order 
bit position of the result operand (for a total of 17 bits in the sum). If there is no carry, 
the carry indicator is turned off. 

Also, if an overflow occurs, the carry indicator contains the sign bit, and the result 
operand contains the low-order 16 bits of the sum. 

The other indicators change to reflect the 16-bit result. 





In this example, AWI adds the decimal value 2502 to the contents of R3, and places the 
result in R1. R3 is unchanged. 
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Add Word with Carry (AWCY) 


Indicators 


AWCY Example 


Subtract Byte (SB) 
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This instruction adds the contents of a specified register, plus the value of the carry 
indicator, to another register. 


AWCY places the final sum of the register specified by the first operand, the register 
specified by the second operand, and the carry indicator in the register specified by the 
second operand. The contents of the first register are unchanged. 








The overflow indicator is cleared. If the addition results in a sum than is less than —2'* or 
greater than +2'5 ~—1, the overflow indicator is turned on. 

The carry indicator is turned on if the addition results in a carry out of the high-order 
bit position of the word (for a total of 17 bits in the sum). If there is no carry, the carry 
indicator is turned off. 

Also, if an overflow occurs, the carry indicator contains the sign bit, and the second 
operand contains the low-order 16 bits of the sum. 

If the zero indicator is on at the beginning of this instruction, it is set to reflect the 
result; if it is off at the beginning, it stays off. The negative indicator reflects the sum, and 
the even indicator is unchanged. 


Assume that the instruction just before this AWCY left the carry indicator on. This 
instruction adds the contents of R6, plus 1, to the contents of R4. Register 4 contains the 
result, and register 6 remains unchanged. 


This instruction subtracts either: 


e A byte in a register from a byte in storage, or 
e A byte in storage from a byte in a register. 





reg, addr4 


If you code the reg,addr4 form, bits 8—15 of reg are subtracted from the byte at addr4. 
In the addr4,reg form, the byte at addr4 is subtracted from bits 8—15 of reg. The 
high-order byte of reg remains unchanged. 


Indicators 


SB Example 


The overflow indicator is cleared. If the subtraction results in a difference that is less than 
—27 or greater than +27—1, the overflow indicator is turned on. | 

The carry indicator is turned on if the subtraction results in a borrow beyond the 
high-order bit position of the byte. If there is no borrow, the carry indicator is turned off. 

Also, if an overflow occurs, the carry indicator contains the complement of the sign bit, 
and the second operand contains the low-order 8 bits of the difference. 

The other indicators change to reflect the 8-bit result. 





In this example, assume that VALOI contains X‘20’, and RS contains X‘2C83’. SB 
subtracts: X‘83’-X‘20’=X‘63’. VALO1 remains unchanged, and register 5 now contains 
X‘2C63’. The carry and overflow indicators are off. 


Subtract Carry Indicator (SCY) 


Indicators 


SCY Example 


Subtract Doubleword (SD) 


This instruction subtracts the value of the carry indicator from a register. 


oe 


The overflow indicator is cleared. If the subtraction results in a difference that is less than 
—2'5 or greater than +2'*°—1, the overflow indicator is turned on. 

The carry indicator is turned on if the subtraction results in a borrow beyond the 
high-order bit position of the register. If there is no borrow, the carry indicator is turned 
off. 

Also, if an overflow occurs, the carry indicator contains the complement of the sign bit, 
and the register contains the low-order 16 bits of the difference. 

If the zero indicator is on at the beginning of this instruction, it is set to reflect the 
result; if it is off at the beginning, it stays off. The negative indicator reflects the sum, and 
the even indicator is unchanged. 









SCY RA 


Assume that R4 contains X°0027’, and the carry indicator is on. SCY subtracts 1 from 
the contents of R4, and the register now contains X‘0026’. 


This instruction subtracts: 


e The contents of a register pair from a doubleword (4 bytes) in storage, 
e A doubleword in storage from the contents of a register pair, or 
e A doubleword in storage from another doubleword in storage. 
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Indicators 


SD Example 


Subtract Word (SW) 
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reg, addr4 
addr4, reg 
addr5, addr4 











[label] 


In either the register-to-storage form or the storage-to-register form, code—for reg—the 
first register of a pair. For example, if you code R2, SD uses registers 2 and 3. If you code 
R7, SD uses registers 7 and 0. 

SD subtracts the contents of the doubleword specified by the first operand from the 
contents of the doubleword specified by the second operand. The first operand remains 
unchanged. 


The overflow indicator is cleared. If the subtraction results in a difference that is less than 
~231 or greater than +2°!—1, the overflow indicator is turned on. 

The carry indicator is turned on if the subtraction results in a borrow beyond the 
high-order bit position. If there is no borrow, the carry indicator is turned off. 

Also, if an overflow occurs, the carry indicator contains the complement of the sign bit, 
and the second operand contains the low-order 32 bits of the difference. 

The other indicators change to reflect the 32-bit result. 


SD _R3, (RI) 


In this example, assume that registers 3 and 4 contain X*10000000’, and register 1 
contains X‘0300’. The doubleword at storage address 0300 contains X‘25000000’. SD 
subtracts: X‘25000000’—X‘10000000’=X‘15000000’. Registers 3 and 4 _ remain 
unchanged, and the doubleword at storage address 0300 contains X‘15000000’. 


This instruction subtracts: 

e A register from a register, 

e A register from a word (2 bytes) in storage, 
e A word in storage from a register, or 

e A word in storage from a word in storage. 


jean 


SW subtracts the contents of the word specified by the first operand from the contents 
of the word specified by the second operand. SW places its result in the second operand. 







reg, reg 
reg, addr4 
addr4, reg 
longaddr, reg 
addr5, addr4 





Indicators 


SW Example 


The overflow indicator is cleared. If the subtraction results in a difference that is less than 
—2'5 or greater than +2'*—1, the overflow indicator is turned on. 

The carry indicator is turned on if the subtraction results in a borrow beyond the 
high-order bit position of the result operand. If there is no borrow, the carry indicator is 
turned off. 

Also, if an overflow occurs, the carry indicator contains the complement of the sign bit, 
and the result operand contains the low-order 16 bits of the difference. 

The other indicators change to reflect the 16-bit result. 


SW THERE, (R2) 


This instruction subtracts the word at location THERE from the word in storage whose 
address is in R2. 


Subtract Word Immediate (SWI) 


This instruction subtracts a 1-word (2-byte) absolute value from a register or from the 
contents of a storage location. 


Indicators 


SWI Example 


word, reg[,reg] 
word, addr4 





For word, code a 16-bit value in the range —32768 to +32767 or 0 to 65535. SWI 
subtracts this value from the contents of the word specified by the second operand. 

In the word,reg|reg| format there is an optional third operand. If you code a register 
for this operand, the result of the subtraction is placed in that register. If you do not code 
the third operand, SWI places the difference in the register specified by the second 
operand. 


The overflow indicator is cleared. If the subtraction results in a difference that is less than 
~2'5 or greater than +2'*—1, the overflow indicator is turned on. 

The carry indicator is turned on if the subtraction results in a borrow beyond the 
high-order bit position of the result operand. If there is no borrow, the carry indicator is 
turned off. 

Also, if an overflow occurs, the carry indicator contains the complement of the sign bit, 
and the result operand contains the low-order 16 bits of the difference. 

The other indicators change to reflect the 16-bit result. 


: swt 2582,R3,R1 


In this example, SWI subtracts the decimal value 2502 from the contents of R3, and 
places the result in R1. 
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Subtract Word with Carry (SWCY) 


Indicators 


SWCY Example 


Multiply Byte (MB) 


Indicators 
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This instruction subtracts the contents of one register and the carry indicator from the 
contents of another register. 


[label] SWCY reg, reg 





SWCY subtracts the contents of the first register and the carry indicator from the 
contents of the second register. SWCY places the final result in the second register, 
leaving the first register unchanged. 


The overflow indicator is cleared. If the subtraction results in a difference that is less than 
~2!5 or greater then +2'° —1. the overflow indicator is turned on. 

The carry indicator is turned on if the subtraction results in a borrow beyond the 
high-order bit position of the register. If there is no borrow, the carry indicator is turned 
off. | 

Also, if an overflow occurs, the carry indicator contains the complement of the sign bit, 
and the second register contains the low-order 16 bits of the difference. 

If the zero indicator is on at the beginning of this instruction, it is set to reflect the 
result; if it is off at the beginning, it stays off. The negative indicator reflects the 
difference, and the even indicator is unchanged. 


“SWCY R6, RA 


Assume that the instruction just before this SWCY left the carry indicator on. This 
instruction subtracts the contents of R6 from R4, then decreases the difference by 1. R4 
contains the result, and R6 remains unchanged. 


This instruction multiplies the contents of a register by a byte in storage. 


MB multiplies the contents of reg by the byte at addr4. The result (1 word) is placed in 
reg. 





The carry and overflow indicators are cleared. If the product of the multiplication cannot 
be represented in 16 bits, the overflow indicator is turned on. If there is an overflow, the 
contents of the result register are undefined. The remaining indicators change to reflect 
the result. 


MB Example 


Multiply Doubleword (MD) 


Indicators 


MD Example 


Multiply Word (MW) 


MB (R3,25) ,R6 


In this example, assume that R3 contains X‘0400’ and register 6 contains X‘0035’. 

MB determines that the address of the byte to be multiplied is X‘0419’ (25 bytes past 
the address in R3). Assume that this byte contains X‘11’. 

MB multiplies: X‘11’xX‘0035’=X‘0385’. This result is placed in register 6. 


This instruction multiplies a word in storage by the contents of a register pair. 


pwn | ww fate 


For the reg operand, code the first register of a register pair. For example, if you code 
R1, MD uses registers 1 and 2. If you code R7, MD uses registers 7 and 0. 

MD multiplies the word at addr4 by the contents of the register pair specified by reg. 
The result (1 doubleword) is placed in the register pair. 









The carry and overflow indicators are cleared. If the product of the multiplication cannot 
be represented in 32 bits, the overflow indicator is turned on. If there is an overflow, the 
contents of the register pair are undefined. The remaining indicators change to reflect the 
result. 


Here is how MD calculates the address of the word to be multiplied: 


1. R1 contains the address of a location in storage. 
2. The contents of that location are another address. 
3. That address value is increased by 8 to form the address of the word to be multiplied. 


MD multiplies the contents of registers 7 and 0 by this word, and places the result in 
registers 7 and 0. 


This instruction multiplies the contents of a register by a word in storage. 


MW multiplies the contents of reg by the word at addr4. The result (1 word) is placed 
in reg. 
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Indicators 


MW Example 


Divide Byte (DB) 


Indicators 


DB Example 


Divide Doubleword (DD) 
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The carry and overflow indicators are cleared. If the product of the multiplication cannot 
be represented in 16 bits, the overflow indicator is turned on. If there is an overflow, the 
contents of the result register are undefined. The remaining indicators change to reflect 
the result. 





The contents of storage at address LOC8 are the address of the word to be multiplied. 
MW fetches the word and multiplies the contents of R6 by it. The product is in R6. 


This instruction divides a byte in storage into the contents of a register. 


DB divides the byte at addr4 into the contents of reg. The quotient is placed in reg, and 
the remainder is placed in the register following the one you coded. For example, if you 
coded R3, the quotient appears in register 3, and the remainder in register 4. If you coded 
R7, the quotient appears in register 7, and the remainder in register 0. 









The overflow indicator is cleared. If you tried to divide by zero, or if the quotient cannot 
be represented in 16 bits, the overflow indicator is turned on. If there is an overflow, the 
result of the division and the remaining indicators are undefined. 

If you tried to divide by zero, the carry indicator is also turned on; otherwise, the carry 
indicator is cleared. The other indicators change to reflect the quotient. 





DB divides the byte whose address is in R1 into the contents of R6. The quotient is in R6 
and the remainder is in R7. 


This instruction divides a word in storage into the contents of a register pair. 


For the reg operand, code the first register of a register pair. For example, if you code 
R2, DD uses registers 2 and 3. If you code R7, DD uses registers 7 and 0. 





Indicators 


DD Example 


Divide Word (DW) 


Indicators 


DW Example 


DD divides the word at addr4 into the contents of the register pair specified by reg. The 
quotient is placed in the register pair, and the remainder is placed in the register following 
the second register of the pair. For example, if you coded R3, the quotient is placed in 
registers 3 and 4, and the remainder in register 5. 


The overflow indicator is cleared. If you tried to divide by zero, or if the quotient cannot 
be represented in 32 bits, the overflow indicator is turned on. If there is an overflow, the 
result of the division and the remaining indicators are undefined. 

If you tried to divide by zero, the carry indicator is also turned on; otherwise, the carry 
indicator is cleared. The other indicators change to reflect the quotient. 





In this example, the storage location whose address is in R1 contains the address of the 
word to be used. DD divides this word into the doubleword in registers 6 and 7. The 
quotient is in registers 6 and 7, and the remainder is in register 0. 


This instruction divides a word in storage into the contents of a register. 


[label] addr4, reg 


DW divides the word at addr4 into the contents of reg. The quotient is placed in reg, 
and the remainder is placed in the register following the one you coded. For example, if 
you coded R5, the quotient appears in register 5, and the remainder in register 6. If you 
coded R7, the quotient appears in register 7, and the remainder in register 0. 








The overflow indicator is cleared. If you tried to divide by zero, or if the quotient cannot 
be represented in 16 bits, the overflow indicator is turned on. If there is an overflow, the 
result of the division and the remaining indicators are undefined. 

If you tried to divide by zero, the carry indicator is also turned on; otherwise, the carry 
indicator is cleared. The other indicators change to reflect the quotient. 





z 


“DW WORDS+4,R7_ 


In this example, the word to be used is 4 bytes past WORDS. DW divides this word into 
the contents of R7. R7 contains the quotient, and RO contains the remainder. 
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Complement Register (CMR) 


Indicators 


CMR Examples 
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This instruction places the complement (in twos complement form) of the contents of a 
register back into the same register or, optionally, into another register. 


pmo fom fm 


Note the optional second operand. If you code this register, CMR places the 
complement of the first register into the second, leaving the first operand unchanged. 
Otherwise, CMR places the complement back into the source register. 









The overflow indicator is cleared. If the number to be complemented is —32768 
(X‘8000’), the overflow indicator is turned on. 
The carry indicator is unchanged. The remaining indicators change to reflect the result. 





Assume that RO contains X‘0003’. CMR places its complement, X‘FFFD’, into RO. 





Assume that RO contains X‘0003’. CMR places its complement, X‘FFFD’, into R6, 
leaving RO unchanged. 


BRANCHING INSTRUCTIONS 


Branch (B) 


Indicators 


B Example 


Branch and Link (BAL) 


Indicators 


BAL Example 


This instruction causes an unconditional branch to the address specified by longaddr. 


All indicators are unchanged. 









Ee rwven gece voles 


This instruction branches to the location whose address it calculates as follows: 


(1) Register 6 contains an address. 
(2) The contents of R6, plus the value of LOC1, plus 4, form an address. 
(3) The contents of that storage location specify the address that B is to branch to. 


This instruction saves—in a register—the address of the next sequential instruction, then 
branches to longaddr. 


Note. If the same register specified as the second operand is also used as a base register in 
longaddr, the initial contents of that register are first used in effective address 
computation and then overwritten with the address of the next sequential instruction. 









All indicators are unchanged. 


In this example, BAL: 


e Determines the address of NEXT, 
© Saves (in register 7) the address of the next sequential instruction, and then 
e Branches to NEXT. 
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Branch and Link External (BALX) 


Indicators 


BALX Example 


This instruction causes an unconditional branch to an address in another source module. 
It saves—in a register—the address of the instruction that follows the BALX instruction. 


BALX vcon, reg 





For vcon, code the external symbol that defines the location to be branched to. For 
reg, code the register that you want to load with the address of the next sequential 
instruction. 

Note. You need not code an EXTRN statement to define the external symbol specified 


by vcon. The vcon symbol must be a valid entry point in another source module. The 
linkage editor will resolve the reference between modules. 


All indicators are unchanged. 





Branch and Link Short (BALS) 
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This instruction saves—in register 7~—the address of the next sequential instruction, then 
branches to the specified address. 


(reg, jdisp)* 
[label ] BALS (reg)* 
addr* 


Code the address of the location whose contents specify the address to be branched to. 
If you specify the (reg,jdisp)* form, jdisp must be in the range —256 to 254. The addr* 
form can be used only when BALS and the address to be branched to are within the 
domain and range of the same USING statement. 

If the implied register (register 7) is used as reg in either (reg,jdisp)* or (reg)*, the initial 
contents of register 7 are first used in effective address computation and then overwritten 
with the address of the next sequential instruction. 









Note. BALS is a 2-byte instruction, and uses only indirect addressing. 


Indicators 


BALS Example 


Branch External (BX) 


Indicators 


BX Example 


All indicators are unchanged. 





In this example, BALS: 
e calculates an address as follows: 
(1) R3 contains an address. 
(2) This address is increased by 28. 
(3) The result is the address of the location that contains the address to be branched 
to. 
e then saves (in register 7) the address of the next sequential instruction, and 
e branches to the address calculated. 


This instruction causes an unconditional branch to an address in another source module. 


SE eee 


For vcon, code the external symbol that defines the location to be branched to. 
Note. The vcon symbol must be a valid entry point in another source module. You need 
not code an EXTRN statement to define the external symbol specified by vcon. The 
linkage editor will resolve the reference between modules. 











All indicators are unchanged. 





“ENTRY ENTERI 
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Branch if Mixed (BMIX) 


Indicators 


BMIX Example 


After a Test Word Immediate (TWI) instruction, BMIX causes a branch if the bits tested 
by TWI are a combination of zeros and ones. 


Note. BMIX actually tests the zero and negative indicators. 


co BMIX longaddr 


All indicators are unchanged. 





Assume that R4 contains X‘002B’. 





Because the bits tested by TWI are a combination of zeros and ones, BMIX causes a 
branch to the address in R2. 


Branch if Not Mixed (BNMIX) 


Indicators 


BNMIX Example 
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After a Test Word Immediate (TWI) instruction, BNMIX causes a branch if the bits tested 
by TWI are either all zeros or all ones. 


Note. BNMIX actually tests the zero and negative indicators. 


[label } BNMIX longaddr 





Note. If the first operand (the 1-word mask) of the TWI instruction is all zeros, the 
resulting condition is not mixed. In this case, BNMIX causes a branch. 


All indicators are unchanged. 


Assume that the word whose address is in R1 contains X‘OOOF’. 





Because the bits tested by TWI are all zeros, BNMIX causes a branch to the location that 
is 4 bytes past the address in R6. 


Branch If Not Off (BNOFF) 


Indicators 


BNOFF Example 


Branch If Not On (BNON) 


Indicators 


BNON Example 


After a Test. Bit (TBT) or Test Word Immediate (TWI) instruction, BNOFF causes a 
branch if: 


e The bit tested by TBT is on, or 
e The bits tested by TWI are either mixed or all on. 


BNOFF longaddr 





Note. BNOFF actually tests the zero indicator. 


All indicators are unchanged. 


Assume that the word at location TEST contains X‘0246’. 


‘TWI_X'g369" ,TEST 
—BNOFF (R3)_ 


Because the bits tested by TWI are mixed, BNOFF causes a branch to the address in R3. 


After a Test Bit (TBT) or Test Word Immediate (TWI) instruction, BNON causes a branch 
if: 

e The bit tested by TBT is off, or 

e The bits tested by TWI are either mixed or all off. 

Note. BNON actually tests the negative indicator. 


Note. If the first operand (the 1-word mask) of a TWI instruction is all zeros, the resulting 
condition is not on. In this case, BNON causes a branch. 





All indicators are unchanged. 


Assume that the word whose address is in R3 contains X‘OOFF’. 


“BNON Loch 


Because the bits tested by TWI are all on, BNON does not cause a branch to LOC4. 
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Branch if Off (BOFF) 


Indicators 


BOFF Example 


Branch if On (BON) 


Indicators 
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After a Test Bit (TBT) or Test Word Immdiate (TWI) instruction, BOFF causes a branch 
if: 

e The bit tested by TBT is off, or 

e The bits tested by TWI are all off. 

Note. BOFF actually tests the zero indicator. 


ta BOFF longaddr 


Note. If the first operand (the 1-word mask) of a TWI instruction is all zeros, the resulting 
condition is off. In this case BOFF causes a branch. 





All indicators are unchanged. 





Assume that the byte whose address is in RO contains: 
0110 += 1001 


Because the eighth bit is on, BOFF does not cause a branch to the address that is 2 bytes 
past location OFF. 


After a Test Bit (TBT) or a Test Word Immediate (TWI) instruction, BON causes a branch 
if: | 
e The bit tested by TBT is on, or 

e The bits tested by TWI are all on. 


Note. BON actually tests the negative indicator. 






All indicators are unchanged. 


BON Example 


Branch Indexed Short (BXS) 


Indicators 


BXS Example 


Branch on Carry (BCY) 


Indicators 





Assume that the byte whose address is in R2 contains: 
0111 OO11 


Because the fourth bit is on, BON causes a branch to the address defined by the contents 
of the location whose address is in R4. 


This instruction causes an unconditional branch to the specified address. 


(reg '~7 , jdisp) . 
[label ] BXS (reg '~7) 
addr 


In the (reg'~” disp) form, jdisp must be in the range -256 to +254. The addr form can 
be used only when BXS and the address to be branched to are within the domain and 
range of the same USING statement. 


Note. BXS is a 2-byte instruction. 





All indicators are unchanged. 





In this example, BXS causes a branch to the location that is 2 bytes past the address in 
register 2. 


This instruction tests the carry indicator. If the indicator is on, BCY branches to 
longaddr. If the indicator is off, the branch is not taken, and the next sequential 
instruction is executed. 


[label] longaddr 


All indicators are unchanged. 
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BCY Example 


Branch on Condition (BC) 


Indicators 


BC Example 


| BCY THERES 


In this example, assume that BCY found the carry indicator on. BCY branches to the 
location that is 6 bytes past THERE. 


This instruction tests a condition that you specify. If the tested condition is met, BC 
causes a branch to longaddr. If the condition is not met, the branch is not taken, and the 
next sequential instruction is executed. 


Code BC to test the indicator settings that result from a previous instruction. For the 
cond operand, code the value of the condition you want to test: 


Zero or equal 

Positive and non-zero 
Negative 

Even 

Arithmetically less than 
Arithmetically less than or equal 
Logically less than or equal 
Logically less than (carry) 
















SAO DWN = © 





All indicators are unchanged. 


In this example, assume that a previous instruction set the negative result indicator on. 
BC causes a branch to NEG3. 


Branch on Condition Code (BCC) 
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This instruction tests the even, carry, and overflow indicators. If the tested condition 
code is met, BCC branches to longaddr. If the condition code is not met, the branch is 
not taken, and the next sequential instruction is executed. 





Indicators 


BCC Example 


Branch on Equal (BE) 


Indicators 


BE Example 


Code BCC to test the indicator settings that result from a previous instruction. For the 
cond operand, specify the condition code you want to test: 
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Abbreviations used for the indicators are: 


e E—even 
e C—carry 
e V—overflow. 


All indicators are unchanged. 





In this example, assume that a previous instruction left the even indicator on, and the 
carry and overflow indicators off. Because only the even indicator is on, BCC does not 
cause a branch to the address in register 3. 


This instruction tests the indicator settings that result from a previous instruction, such as 
a compare, for an equal condition. If the condition is met, BE causes a branch to 
longaddr. If the condition is not met, the branch is not taken, and the next sequential 
instruction is executed. 


Note. This instruction actually tests the zero result indicator. 









All indicators are unchanged. 





Assume that this BE was preceded by a compare instruction whose result was equal. BE 
branches to EQUAL. 
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Branch on Error (BER) 


This instruction tests the condition code (after an I/O operation) for an error condition. 
If there is an error, BER causes a branch to longaddr. 


[label] longaddr 


Note. Coding this instruction does the same thing as coding the BNCC instruction to 
branch on condition code not 7. 





Indicators 
All indicators are unchanged. 


Branch on Even (BEV) 


This instruction tests the even indicator. If the previous instruction left it on, BEV causes 
a branch to longaddr. If the indicator is off, the branch is not taken, and the next 
sequential instruction is executed. 





Indicators 
All indicators are unchanged. 


BEV Example 





In this example assume that the previous instruction left the even indicator on. BEV 
causes a branch to the address in register 4. 


Branch on Greater Than (BGT) 


This instruction tests the indicator settings that result from a previous instruction for an 
arithmetically greater than condition. If the condition is met, BGT causes a branch to 
longaddr. If the condition is not met, the branch is not taken, and the next sequential 
instruction is executed. 


va _ 


Note. This instruction actually tests the negative, overflow, and zero result indicators. 
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Indicators 


BGT Example 


All indicators are unchanged. 


BGT GREATER+6 


In this example, assume that the previous instruction left an arithmetically greater than 
condition. BGT causes a branch to the location that is 6 bytes past GREATER. 


Branch on Greater Than or Equal (BGE) 


Indicators 


BGE Example 


Branch on Less Than (BLT) 


Indicators 


This instruction tests the indicator settings that result from previous instruction for an 
arithmetically greater than or an equal condition. If either condition is met, BGE causes a 
branch to longaddr. If neither condition is met, the branch is not taken, and the next 
sequential instruction is executed. 


[label] BGE longaddr 





Note. This instruction actually tests the negative and overflow indicators. 


All indicators are unchanged. 


“BGE (R3) 


In this example, assume that the previous instruction left a less than condition. BGE does 
not cause a branch to the address in register 3. 


This instruction tests the indicator settings that result from a previous instruction for an 
arithmetically less than condition. If the condition is met, BLT causes a branch to 
longaddr. If the condition is not met, the branch is not taken, and the next sequential 
instruction is executed. 


Note. This instruction actually tests the negative and overflow indicators. 









All indicators are unchanged. 
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BLT Example 


In this example, assume that the previous instruction left an arithmetically less than 
condition. BLT branches to the location that is 3 bytes past address LESS. Note that 
LESS+3 must be an even byte address. 


Branch on Less Than or Equal (BLE) 


This instruction tests the indicator settings that result from a previous instruction for an 
arithmetically less than or an equal condition. If either condition is met, BLE causes a 
branch to the address specified by longadadr. If neither condition is met, the branch is not 
taken, and the next sequential instruction is executed. 


Note. This instruction actually tests the negative, overflow, and zero result indicators. 









Indicators 
All indicators are unchanged. 


BLE Example 





In this example, assume that the previous instruction left an equal condition. BLE causes 
a branch to the location that is 4 bytes before address THERE. 


Branch on Logically Greater Than (BLGT) 
This instruction tests the indicator settings that result from a previous instruction, such as 
a compare, for a logically greater than condition. If the condition is met, BLGT causes a 
branch to longaddr. If the condition is not met, the branch is not taken, and the next 
sequential instruction is executed. 


Note. This instruction actually tests the carry and zero indicators. If both are off, the 
branch is taken. For more information about how the indicators are set, see “Compare 
Instructions.” 









Indicators 
All indicators are unchanged. 
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BLGT Example 


In this example, assume that the previous instruction was a compare instruction whose 
result was logically greater than. BLGT causes a branch to the address in register 2. 


Branch on Logically Greater Than or Equal (BLGE) 


Indicators 


BLGE Example 


This instruction tests the indicator settings that result from a previous instruction, such as 
a compare, for a logically greater than or equal condition. If either condition is met, 
BLGE causes a branch to longaddr. If neither condition is met, the branch is not taken, 
and the next sequential instruction is executed. 


[label] BLGE longaddr 


Note. This instruction actually tests the carry indicator; if it is off, the branch is taken. 
For more information about how the indicator is set, see “Compare Instructions.” 





All indicators are unchanged. 


“BLGE (R2,L0CI) 


In this example, assume that the previous instruction set a condition of equal. BLGE 


‘causes a branch to the location whose address is the contents of register 2, increased by 


the value of LOC1. 


Branch on Logically Less Than (BLLT) 


Indicators 


This instruction tests the indicator settings that result from a previous instruction, such as 
a compare, for a logically less than condition. If the condition is met, BLLT causes a 
branch to longaddr. If the condition is not met, the branch is not taken, and the next 
sequential instruction is executed. 


[label ] BLLT longaddr 


Note. This instruction actually tests the carry indicator; if it is on, the branch is taken. 
For more information about how the indicator is set, see “Compare Instructions.” 





All indicators are unchanged. 
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BLLT Example 





In this example, assume that the previous instruction set a condition of equal. BLLT does 
not cause a branch to LESS. 


Branch on Logically Less Than or Equal (BLLE) 


Indicators 


BLLE Example 


Branch on Negative (BN) 


Indicators 
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This instruction tests the indicator settings that result from a previous instruction, such as 
a compare, for a logically less than or equal condition. If either condition is met, BLLE 
causes a branch to longadadr. If neither condition is met, the branch is not taken, and the 
next sequential instruction is executed. 


[label | BLLE longaddr 


Note. This instruction actually tests the carry and zero indicators. For more information 
about how the indicators are set, see “Compare Instructions.” 





All indicators are unchanged. 





In this example, assume that the previous instruction set a condition of logically less than. 
BLLE branches to the address defined by the contents of the storage location whose 
address is in register 6. 


This instruction tests the negative result indicator. If it is on, BN causes a branch to 
longaddr. If the indicator is off, the branch is not taken, and the next sequential 
instruction is executed. 


All indicators are unchanged. 





BN Example 


Branch on No Carry (BNCY) 


Indicators 


BNCY Example 


Branch on Not Condition (BNC) 


“AYA A hh WY = © 





In this example, assume that the previous instruction turned off the negative result 
indicator. BN does not cause a branch to the location that is 6 bytes past LOC3. 


This instruction tests the carry indicator. If it is off, BNCY causes a branch to longaddr. 
If the indicator is on, the branch is not taken, and the next sequential instruction is 
executed. : 


All indicators are unchanged. 








In this example, assume that the previous instruction left the carry indicator off. BNCY 
causes a branch to NOCARRY. | 


This instruction tests a condition that you specify. If the condition is met, BNC causes a 
branch to longaddr. If the condition is not met, the branch is not taken, and the next 
sequential instruction is executed. 


Code BNC to test the indicator settings that result from a previous instruction. For the 
cond operand, code the value of the condition you want to test: 


Non-zero or non-equal 
Not positive 
Not negative 
Not even 
Arithmetically greater than or equal 
_ Arithmetically greater than 
Logically greater than 
Logically greater than or equal (no carry) 
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Indicators 
All indicators are unchanged. 


BNC Example 


In this example, assume that the previous instruction set an equal condition. BNC does 
not cause a branch to LESS. 


Branch on Not Condition Code (BNCC) 


This instruction tests the even, carry, and overflow indicators. If the tested condition 
code is not met, BNCC causes a branch to longaddr. If the condition code is met, the 
branch is not taken, and the next sequential instruction is executed. 


Code BNCC to test the indicator settings that result from a previous instruction. For 
the cond operand, specify the condition code you want to test: 







cond, longaddr 
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The abbreviations used for the indicators are: 


e E—even 
e C-—carry 
e V—overflow 


Indicators 
All indicators are unchanged. 


BNCC Example 





In this example, assume that the previous instruction left the even and carry indicators 
off. BNCC causes a branch to the address in register 3. 
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Branch on Not Equal (BNE) 


Indicators 


BNE Example 


Branch on Not Error (BNER ) 


Indicators 


Branch on Not Even (BNEV) 


Indicators 





This instruction tests the indicator settings that result from a previous instruction, such as 
a compare, for an equal condition. If the condition is not met, BNE causes a branch to 
longaddr. If the condition is met, the branch is not taken, and the next sequential 
instruction is executed. 


[label] longaddr 


Note. This instruction actually tests the zero indicator. 





All indicators are unchanged. 


_ BNE. UNEQUAL 


In this example, assume that the previous instruction left an equal condition. BNE does 
not cause a branch to UNEQUAL. 


This instruction tests the condition code (after an I/O operation) for an error condition. 
If there is no error, BNER causes a branch to longadadr. 


[label] BNER 


Note. Coding this instruction does the same thing as coding the BCC instruction to 
branch on condition code 7. 





longaddr 





All indicators are unchanged. 


This instruction tests the even result indicator. If a previous instruction left it off, BNEV 
causes a branch to longaddr. If the indicator is on, the branch is not taken, and th next 
sequential instruction is executed. 


All indicators are unchanged. 
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BNEV Example 
_BNEV (R6)* 
pee cere ee 
In this example, assume that BNEV found the even indicator off. BNEV causes a branch 


to the address defined by the contents of the location whose address is in register 6. 


Branch on Not Negative (BNN) 


This instruction tests the negative result indicator. If it is off, BNN causes a branch to 
longaddr. If the indicator is on, the branch is not taken, and the next sequential 
instruction is executed. 


[label } longaddr , ae 


All indicators are unchanged. 





Indicators 


BNN Example 





é ae OR PE eG 
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In this example, assume that the previous instruction turned off the negative indicator. 
BNN causes a branch to the location that is 6 bytes past LOC3. 


Branch on Not Overflow (BNOV) 


This instruction tests the overflow indicator. If it is off, BNOV causes a branch to 
longaddr. If the indicator is on, the branch is not taken, and the next sequential 
instruction is executed. 


All indicators are unchanged. 





Indicators 


BNOV Example | 


In this example, assume that the previous instruction turned on the overflow indicator. 
BNOV does not cause a branch to the address in register 2. 
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Branch on Not Positive (BNP) 


Indicators 


BNP Example 


Branch on Not Zero (BNZ) 


Indicators 


BNZ Example 


This instruction tests the indicator settings that result from a previous instruction for a 
positive condition. If the condition is not met, BNP causes a branch to longaddr. If the 
condition is met, the branch is not taken, and the next sequential instruction is executed. 


Note. This instruction actually tests the negative and zero result indicators. 









All indicators are unchanged. 


BNP LOC5-8 | 


In this example, assume that the previous instruction turned on the negative indicator. 
BNP causes a branch to the location that is 8 bytes before LOCS. 


This instruction tests the zero result indicator. If it is off, BNZ causes a branch to 
longaddr. If the indicator is on, the branch is not taken, and the next sequential 
instruction is executed. 


All indicators are unchanged. 
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In this example, assume that the previous instruction turned off the zero indicator. BNZ 
causes a branch to the address defined by the contents of the location whose address is in 
register 5. 
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Branch on Overflow (BOV) 


Indicators 


BOV Example 


Branch on Positive (BP) 


Indicators 


BP Example 
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This instruction tests the overflow indicator. If it is on, BOV causes a branch to longaddr. 
If it is off, the branch is not taken, and the next sequential instruction is executed. 


All indicators are unchanged. 












In this example, assume that the previous instruction turned on the overflow indicator. 
BOV causes a branch to OVER. 


This instruction tests the indicator settings that result from a previous instruction for a 
positive condition. If the condition is met, BP causes a branch to longaddr. If the 
condition is not met, the branch is not taken, and the next sequential instruction is 
executed. | 









Note. This instruction actually tests the negative and zero result indicators. 


All indicators are unchanged. 





In this example, assume that the previous instruction turned on the negative indicator. BP 
does not cause a branch to the location that is 4 bytes before LOCS. 


_ Branch on Zero (BZ) 


Indicators 


BZ Example 


No Operation (NOP) 


Indicators 


This instruction tests the zero result indicator. If it is on, BZ causes a branch to longaddr. 
If the indicator is off, the branch is not taken, and the next sequential instruction is 
executed. 


ee 


All indicators are unchanged. 








In this example, assume that the previous instruction turned off the zero indicator. BZ 
does not cause a branch to ZERO. 


This instruction causes an unconditional branch to the next sequential instruction. 






All indicators are unchanged. 
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Coding Jump Instructions 
You can jump to locations that are within the same CSECT as the jump instruction. For 
all jump instructions, code either the jdisp or jaddr operand to specify the address to be 
jumped to. This address must be within —256 to 254 bytes of the byte following the jump 
instruction. 

If you use the jdisp form, code—as an even absolute value or expression—a displacement 
from the byte following the jump instruction. ; 

If you use the jaddr form, code—as a relocatable expression—the even byte address you 
want to jump to. | 
Note. The IAR points to the byte following the jump instruction; therefore, jdisp is 
actually a displacement from the IAR. Jump instructions are the only IAR-relative 
instructions. : 


Jump (J) 


This instruction causes an unconditional jump to the specified address. 


J jdisp 
jaddr 


All indicators are unchanged. 









Indicators 


J Example 





This instruction causes a jump to the location THERE. 


Jump and Link (JAL) 


This instruction saves—in a register—the address of the next sequential instruction, then | 
causes a jump to the specified location. 


For reg specify the register in which you want to save the address of the next sequential 
instruction. 





jdisp reg 
jaddr,reg 





Indicators 
All indicators are unchanged. 
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JAL Example 


Jump if Mixed (JMIX) 


Indicators 


JMIX Example 


Jump If Not Mixed (JNMIX) 


Indicators 





In this example, JAL saves—in register 7—the address of the instruction that follows this 
JAL. This instruction then causes a jump to the location that is 8 bytes past the byte that 
follows this JAL instruction. 


After a Test Word Immediate (TWI) instruction, JMIX causes a jump if the bits tested by 
TWI are a combination of zeros and ones. 


jdisp 


Note. JMIX actually tests the zero and negative indicators. 





All indicators are unchanged. 


Assume that the word at location TEST contains X‘0369’. 


WI X'9369' TEST 
JMIX MIXED 


Because the bits tested by TWI are all ones, JMIX does not cause a jump to location 
MIXED. 


After a Test Word Immediate (TWI) instruction, JNMIX causes a jump if the bits tested 
by TWI are either all zeros or all ones. 


Note. JNMIX actually tests the zero and negative indicators. 


jdisp 


Note. If the first operand (the 1-word mask) of the TWI instruction is all zeros, the 
resulting condition is not mixed. In this case, JNMIX causes a jump. 





All indicators are unchanged. 
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JNMIX Example 


Jump if Not Off (JNOFF) 


Indicators 


JNOFF Example 


Jump if Not On (JNON) 


Indicators 
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Assume that R4 contains X‘0000’. 


TW) X' OFF" Rh 
INMIX 14 


Because the bits tested by TWI are all zeros, JNMIX causes a jump to the location that is 
14 bytes past the byte following this JNMIX. 


After a Test Bit (TBT) or Test Word Immediate (TWI) instruction, JNOFF causes a jump 
if: 


e The bit tested by TBT is on, or 
e The bits tested by TWI are either mixed or all on. 


jdisp 


Note. JNOFF actually tests the zero indicator. 





All indicators are unchanged. 


Assume that the word whose address is in R3 contains X‘O3AC’. 


TWh xt ge53", (R3) 
—JNOFF 36 


Because the tested bits are all off, JNOFF does not cause a jump to the location that is 36 
bytes past the byte following this JNOFF. 


After a Test Bit (TBT) or Test Word Immediate (TWI) instruction, JNON causes a jump + 
if: | 


e The bit tested by TBT is off, or 
e The bits tested by TWI are either mixed or all off. 


Note. JNON actually tests the negative indicator. 


jdisp 


Note. If the first operand (the 1-word mask) of a TWI instruction is all zeros, the resulting 
condition is not on. In this case, JNON causes a jump. 





All indicators are unchanged. 


JNON Example 


Jump if Off (JOFF) 


Indicators 


JOFF Example 


Jump if On (JON) 


Indicators 


Assume that the word in R7 contains X‘0123’. 


TW X'g321",R 
«Mo 268720987 


Because the tested bits are mixed, JNON causes a jump to the location that is 6 bytes 
before the byte following this JNON. 


After a Test Bit (TBT) or Test Word Immediate (TWI) instruction, JOFF causes a jump 
if: 

e The bit tested by TBT is off, or 

e The bits tested by TWI are all off. 


Note. JOFF actually tests the zero indicator. 


jdisp 


Note. If the first operand (the 1-word mask) of a TWI instruction is all zeros, the resulting 
condition is off. In this case, JOFF causes a jump. 





All indicators are unchanged. 


—TBT — (R6,5) 
_ SOFF OFF 


Assume that the byte whose address is in R6 contains: 
1111 0000 
Because the sixth bit is off, JOFF causes a jump to location OFF. 


After a Test Bit (TBT) or Test Word Immediate (TWI) instruction, JON causes a jump if: 


e The bit tested by TBT is on, or 
e The bits tested by TWI are all on. 


jdisp 


Note. JON actually tests the negative indicator. 





All indicators are unchanged. 


Machine Instructions 4-57 


JON Example 


Jump on Carry (JCY) 


Indicators 


JCY Example 


Jump on Condition (JC) 
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Assume that the byte whose address is in R1 contains: 
0000 1111 


Because the first bit is off, JON does not cause a jump to the address that is 4 bytes past 
location ON. 


This instruction tests the carry indicator. If the indicator is on, JCY jumps to the 
specified location. If the indicator is off, the jump is not taken, and the next sequential 
instruction is executed. 





All indicators are unchanged. 





In this example, assume that JCY found the carry indicator on. JCY jumps to the 
location that is 4 bytes before the address CARRY. 


This instruction tests a condition that you specify. If the tested condition is met, JC 
causes a jump to the specified location. If the condition is not met, the jump is not taken, 
and the next sequential instruction is executed. 


d, jdis 
label cond, Jdisp 
Habel cond, jaddr | 





Indicators 


JC Example 


Jump on Count (JCT) 


Code the JC instruction to test the indicator settings that result from a previous 
instruction. For the cond operand, code the value of the condition you want to test: 


Zero or equal 

Positive and non-zero 

Negative 

Even 

Arithmetically less than 
Arithmetically less than or equal 
Logically less than or equal 
Logically less than (carry) 


0 
1 
2 
3 
4 
5 
6 
7 





All indicators are unchanged. 





In this example assume that a previous instruction set the negative result indicator on. JC 
causes a jump to the location that is 10 bytes past the byte following this JC instruction. 


This instruction tests the contents of the specified register. If the contents of the register 
are not zero, JCT decreases the register by 1. If the contents are still not zero, JCT causes 
a jump to the specified location. 


NO JUMP 












Subtract 1 
from reg 





NO JUMP 
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Indicators 


JCT Example 


Jump on Equal (JE) 


Indicators 


JE Example 


Jump on Even (JEV) 


Indicators 
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jdisp, reg 
jaddr, reg 





All indicators are unchanged. 


Assume that R3 (before the decrement) contains X‘0025’. JCT decreases R3 by 1, leaving 
X‘0024’, and causes a jump to ZERO. 


This instruction tests the result of a previous instruction, such as a compare, for an equal 
condition. If the condition is met, JE causes a jump to the specified location. If the 
condition is not met, no jump is taken, and the next sequential instruction is executed. 


jdisp 


Note. This instruction actually tests the zero result indicator. 









All indicators are unchanged. 





Assume that this JE was preceded by a compare instruction whose result was equal. JE 
causes a jump to EQUAL. 


This instruction tests the even indicator. If a previous instruction left it on, JEV causes a 
jump to the specified location. If the indicator is off, the jump is not taken, and the next 
sequential instruction is executed. 


jdisp 


All indicators are unchanged. 













JEV Example 





In this example assume that the previous instruction left the even indicator on. JEV 


causes a jump to the location that is 26 bytes past the byte following this JEV. 


Jump on Greater Than (JGT) 


Indicators 


JGT Example 


This instruction tests the result of a logical instruction for an arithmetically greater than 
condition. If the condition is met, JGT causes a jump to the specified location. If the 
condition is not met, the jump is not taken, and the next sequential instruction is 
executed. 


jdisp 
jaddr 





[label] IGT 







Note. This instruction actually tests the negative, overflow, and zero result indicators. 


All indicators are unchanged. 


“SGT GREATER+6 


In this example, assume that the previous instruction left a greater than condition. JGT 
causes a jump to the location that is 6 bytes past GREATER. 


Jump on Greater Than or Equal (JGE) 


Indicators 


This instruction tests the result of a logical instruction for an arithmetically greater than 
or an equal condition. If either condition is met, JGE causes a jump to the specified 
location. If neither condition is met, the jump is not taken, and the next sequential 
instruction is executed. 


jdisp 
jue foe fe 


Note. This instruction actually tests the negative and overflow indicators. 





All indicators are unchanged. 
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JGE Example 


Jump on Less Than (JLT) 


Indicators 


JLT Example 





{2 #32 F fe ee 4 
EH : : 
ee ie ae a ae a 


In this example, assume that the previous instruction left a Jess than condition. JGE does 
not cause a jump to the location that is 84 bytes past the byte that follows this JGE 
instruction. 


This instruction tests the result of a logical instruction for an arithmetically less than 
condition. If the condition is met, JLT causes a jump to the specified location. If the 
condition is not met, the jump is not taken, and the next sequential instruction is 
executed. 


| 





Note. This instruction actually tests the negative and overflow indicators. 


All indicators are unchanged. 








: 
7 x A nem Bg | i 
He ry J 
4 oo : a et oe & 
‘ ae ee a ae ea a ee 


In this example, assume that the previous instruction left a less than condition. JLT 
causes a jump to the location that is 2 bytes past LESS. 


Jump on Less Than or Equal (JLE) 


This instruction tests the result of a logical instruction for an arithmetically less than or 
an equal condition. If either condition is met, JLE causes a jump to the specified 
location. If neither condition is met, the jump is not taken, and the next sequential 
instruction is executed. : 


Indicators 
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Note. This instruction actually tests the overflow, negative, and zero result indicators. 


All indicators are unchanged. 


_JLE Example 





In this example, assume that the previous instruction left an equal condition. JLE causes 
a jump to the location that is 4 bytes before address THERE. 


Jump on Logically Greater Than (JLGT) 


Indicators 


JLGT Example 


This instruction tests the result of a logical instruction, such as a compare, for a logically 
greater than condition. If the condition is met, JLGT causes a jump to the specified 
location. If the condition is not met, the jump is not taken, and the next sequential 
instruction is executed. 





JLGT 


Note. This instruction actually tests the carry and zero indicators. If both indicators are 
off, the jump is taken. For more information about how the indicators are set, see 
“Logical Instructions.” 


All indicators are unchanged. 





In this example, assume that the previous instruction was a compare instruction whose 
result was logically greater than. JLGT causes a jump to location THERE. 


Jump on Logically Greater Than or Equal (JLGE) 


Indicators 


This instruction tests the result of a logical or arithmetic instruction, such as a compare or 
subtract, for a logically greater than or logically equal condition. If either condition is 
met, JLGE causes a jump to the specified location. If neither condition is met, the jump 
is not taken, and the next sequential instruction is executed. 


jdisp 
jaddr 





JLGE 






Note. This instruction actually tests the carry indicator; if it is off, the jump is taken. For 
more information about how the indicator is set, see “Logical Instructions“ and 
“Arithmetic Instructions.” 


All indicators are unchanged. 
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JLGE Example 





Assume that this JLGE appears in this piece of code: 


X MVWE 14,R2 


MVA LOC,RI 
CW -R3, RA 
JLGE -12 

CMR RI,R2 


If CW R3,R4 set a condition of logically greater than or equal, JLUGE —-12 causes a jump 
to MVWI 14,R2. (JLGE X would do the same thing.) 


Jump on Logically Less Than (JLLT) 


Indicators 


JLLT Example 
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This instruction tests the result of a logical instruction, such as a compare, for a logically 
less than condition. If the condition is met, JLLT causes a jump to the specified location. | 
If the condition is not met, the jump is not taken, and the next sequential instruction is 
executed. 


jdisp 


Note. This instruction actually tests the carry indicator—if it is on, the jump is taken. For 
more information about how the indicator is set, see “Logical Instructions.” 









All indicators are unchanged. 





In this example assume that the previous instruction set a condition of equal. JLLT does 
not cause a jump to LESS. 


Jump on Logically Less Than or Equal (JLLE) 


Indicators 


JLLE Example 


Jump on Negative (JN) 


Indicators 


JN Example 


This instruction tests the result of a logical instruction, such as a compare, for a logically 
less than or equal condition. If either condition is met, JLLE causes a jump to the 
specified location. If neither condition is met, the jump is not taken, and the next 
sequential instruction is executed. 


jdisp 


Note. This instruction actually tests the carry and zero indicators. Both indicators must 
be on for the jump to be taken. For more information about how the indicators are set, 
see “Logical Instructions.” 





All indicators are unchanged. 





In this example, assume that the previous instruction set a condition of logically less than. 
JLLE causes a jump to LESS. 


This instruction tests the negative result indicator. If it is on, JN causes a jump to the 
specified location. If the indicator is off, the jump is not taken, and the next sequential 
instruction is executed. 


jdisp 


All indicators are unchanged. 


In this example, assume that the previous instruction turned off the negative result 
indicator. JN does not cause ajump to the location that is 6 bytes past LOC3. 
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Jump on No Carry (JNCY) 


This instruction tests the carry indicator. If it is off, JNCY causes a jump to the specified 
location. If the indicator is on, the jump is not taken, and the next sequential instruction 
is executed. | | 


[label] JNCY 


All indicators are unchanged. 


aac aga 


In this example assume that the previous instruction left the carry indicator off. JNCY 
causes a jump to NOCARRY. 


Jump on Not Condition (JNC) 


This instruction tests a condition that you specify. If the condition is met, JNC causes a 
jump to the specified location. If the condition is not met, the jump is not taken, and the 
next sequential instruction is executed. 


tw [me 


Code JNC to test the result of a previous instruction. For the cond operand, code the | 
value of the condition you want to test: ne 


Non-zero or non-equal 

Not positive 

Not negative 

Not even 

Arithmetically greater than or equal 
Arithmetically greater than 

Logically greater than 

Logically greater than or equal (no carry) 





Indicators 


JNCY Example 











cond, jdisp 
cond, jaddr 








“IAA RW DY KH © 





Indicators 
All indicators are unchanged. 
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JNC Example 


Jump on Not Equal (JNE) 


Indicators 


JNE Example 


Jump on Not Even (JNEV) 


Indicators 


JNEV Example 


In this example, assume that the previous instruction set a logically equal condition. JNC 
does not cause a jump to the location that is 12 bytes before the byte that follows the 
JNC instruction. 


This instruction tests the result of a previous instruction, such as a compare, for an equal 
condition. If the condition is not met, JNE causes a jump to the specified location. If the 
condition is met, the jump is not taken, and the next sequential instruction is executed. 


jdisp 


Note. This instruction actually tests the zero result indicator. 





All indicators are unchanged. 


SNE UNEQUAL +- 


In this example, assume that the previous instruction left an equal condition. JNE does 
not cause a jump to UNEQUAL. 


This instruction tests the even result indicator. If a previous instruction left it off, JNEV 
causes a jump to the specified location. If the indicator is on, the jump is not taken, and 
the next sequential instruction is executed. 





jdisp 


JNEV jaddr 







All indicators are unchanged. 


In this example, assume that JNEV found the even indicator off. JNEV causes a jump to 
the location that is 6 bytes past the byte following this JNEV instruction. 
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Jump on Not Negative (JNN) 


Indicators 


JNN Example 


Jump on Not Positive (JNP) 


Indicators 


JNP Example 
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This instruction tests the negative result indicator. If it is off, JNN causes a jump to the 
specified location. If the indicator is on, the jump is not taken, and the next sequential 
instruction is executed. 


jdisp 


All indicators are unchanged. 









NN LOC3~6 


In this example assume that the previous instruction turned off the negative indicator. 
JNN causes a jump to the location that is 6 bytes before LOC3. 


This instruction tests the result of a previous instruction for a positive condition. If the 
condition is not met, JNP causes a jump to the specified location. If the condition is met, 
the jump is not taken, and the next sequential instruction is executed. 


jdisp 
me foe | 


Note. This instruction actually tests the negative and zero result indicators. 





All indicators are unchanged. 


INP THERE 


In this example assume that the previous instruction turned off the negative and zero 
indicators (leaving a positive condition). JNP does not cause a jump to THERE. 


Jump on Not Zero (JNZ) 


Indicators 


JNZ Example 


Jump on Positive (JP) 


Indicators 


JP Example 


This instruction tests the zero result indicator. If it is off, JNZ causes a jump to the 
specified location. If the indicator is on, the jump is not taken, and the next sequential 
instruction is executed. 


jdisp 


All indicators are unchanged. 





JNZ <4 


In this example assume that the previous instruction turned off the zero indicator. JNZ 
causes a jump to the location that is 4 bytes before the byte following this JNZ 
instruction. 


This instruction tests the result of a previous instruction for a positive condition. If the 
condition is met, JP causes a jump to the specified location. If the condition is not met, 
the jump is not taken, and the next sequential instruction is executed. 


jdisp 
ponte fe 


Note. This instruction actually tests the negative and zero result indicators. 





All indicators are unchanged. 


JP Loc5~12 


In this example assume that the previous instruction turned on the negative indicator. JP 
does not cause a jump to the location that is 12 bytes before LOCS. 
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Jump on Zero (JZ) 


Indicators 


JZ Example 
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This instruction tests the zero result indicator. If it is on, JZ causes a jump to the 
specified location. If the indicator is off, the jump is not taken, and the next sequential 
instruction is executed. 


jdisp 


All indicators are unchanged. 





_ JZ ZERO 


In this example, assume that the previous instruction turned off the zero indicator. JZ 
does not cause a jump to ZERO. 


SHIFT INSTRUCTIONS 
Coding Shift Instructions 


Shift Left Circular (SLC) 


Indicators 


SLC Example 


The shift instructions all have the same basic syntax. The first operand is always the shift 
count, and the second is always the register to be shifted. 

You can code shift count as an absolute value or expression, or you can code it in 
register form, where bits 8—15 of the register contain the count. If the shift count is in a 
register, that register is not altered by the shift instruction, unless the instruction is SLT 
or SLTD, or the same register is also specified as the register to be shifted. 


Note. For SLT and SLTD, code the shift count in register form only. 


If you code a shift count value, it can be in the range 0O—16 (for cnt16) or O—31 (for 
cnt31), You may code a value greater than 16 for ent16, however, it will be flagged with 
a warning message. When the instruction is executed, a shift count greater than 16 will 
lengthen the execution time. If you code a register that contains the shift count, the 
count can be in the range 0—255. Note that if you code a shift count of 0, the register is 
not shifted. 

The second operand is the register to be shifted. In the case of double shift instructions, 
the register you code here is the first register of a register pair. For example, if you code 
RS, the instruction shifts the pair R5,R6. If you code R7, the instruction shifts the pair 
R7,RO. 


This instruction shifts the contents of a register to the left by a specified number of bits. 
The bits shifted out of the high-order bit (bit 0) reenter in the low-order bit (bit 15). 


cnt16, reg 
reg, reg 





The carry and overflow indicators are unchanged. The remaining indicators reflect the 
final contents of the register. 


SLC 3,R6 


Before the shift, register 6 contains: 
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Shift Left Circular Double (SLCD) 


This instruction shifts the contents of a register pair to the left by a specified number of 
bits. The bits shifted out of the high-order bit (bit 0) reenter in the low-order bit (bit 31). 


cnt31, reg 
reg, reg 





Indicators 
The carry and overflow indicators are unchanged. The remaining indicators reflect the 
final contents of the register pair. 

SLCD Example 


SLED 4,RI 


Before the shift, the register pair R1, R2 contains: 


R2 





After the shift, the register pair R1, R2 contains: 


Rl R2 l 





_ Shift Left Logical (SLL) 


This instruction shifts the contents of a register to the left by a specified number of bits. 
The vacated low-order bits are filled with zeros. 


cnt16, reg 
reg, reg 







Indicators 


The overflow indicator is first reset, then set to 1 if the most significant bit in the register 
changed during the shift. The carry indicator reflects the last bit shifted out of bit 0. The 
remaining indicators reflect the final contents of the register. 
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SLL Example 





SLL_1,R7 


Before the shift, register 7 contains: 


or 7, 
. RRRRRRR asoteatatatecatecanatasete*etetetetatatstorete angi arstatatetets tetera a! 








& 


After the shift 





, register 7 contains: 


* 
a eratetatetatel 
eoretet 






Shift Left Logical Double (SLLD) 
This instruction shifts the contents of a register pair to the left by a specified number of 


Indicators 


SLLD Example 


bits. The vacated low-order bits are filled with zeros. 


cnt31, reg 
reg, reg 





The overflow indicator is first reset, then set to 1 if the most significant bit in the register 
pair changed during the shift. The carry indicator reflects the last bit shifted out of bit 0. 


The remaining indicators reflect the final contents of the register pair. 


- SLLD R7,R4 


Assume that register 7 contains X‘000C’. 
Before the shift, the register pair R4, R5 contains: 


R4 R5 
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Shift Left and Test (SLT) 


This instruction shifts the contents of a register to the left. It continues shifting until it 
has: 


e Shifted the number of bits specified as a shift count, or 
e Shifted a 1-bit out of bit zero. 


The vacated low-order bits are filled with zeros. 


If SLT shifts a 1-bit out of bit zero before it has shifted the number of bits you 
specified, the remaining shift count is loaded into bits 8—15 of the register you coded for 
the first operand. 









Indicators 


The overflow and carry indicator are first reset. Then the overflow indicator is set to 1 if 
the most significant bit in the register changed during the shift. The carry indicator 
reflects the last bit shifted out of bit 0. The remaining indicators reflect the contents of 
the register you coded for the first operand. 

SLT Example 


SUT R5,R2 


In this example, assume that register 5 contains X‘000C’. 
Before the shift, register 2 contains: 


OND 


0000 0000 185G:02 8%: 
ote a 









After the shift, register 2 contains: 


% 
se 
o5e.9, 
sete! 
"etete: 
erorore’ 
e: 


$¥0 0000 0000 


atete te Oe UN Oe Ow 0 0.8 
ratetatetatatererere 0.6,510.0-0.0000000.0 


0 15 


and register 5 contains X‘0003’, the shift count that remained after SLT shifted a 1-bit 
out of the high-order bit of the register. | 
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Shift Left and Test Double (SLTD) 


Indicators 


SLTD Example 


This instruction shifts the contents of a register pair to the left. It continues shifting until 
it has: 

e Shifted the number of bits specified as a shift count, OR 

e Shifted a 1-bit out of bit zero of the first register in the pair. 

The vacated low-order bits are filled with zeros. 


If SLTD shifts a 1-bit out of bit zero before it has shifted the number of bits you 
specified, the remaining shift count is loaded into bits 8—15 of the register you coded for 
the first operand. 





The carry and overflow indicators are first reset. Then the overflow indicator is set to 1 if 
the most significant bit in the register pair changed during the shift. The carry indicator 
reflects the last bit shifted out of bit 0. The remaining indicators reflect the contents of 
the register you coded for the first operand. 


SLTD R1,R2 


In this example, assume that register 1 contains X‘0003’. 
Before the shift, register pair R2, R3 contains: 





and R1 contains 0. 
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Shift Right Arithmetic (SRA) 


Indicators 


SRA Example 


This instruction shifts the contents of a register to the right by a specified number of bits. 


The original high-order bit of the register is propagated through the vacated high-order 
bits. 


The carry and overflow indicators are unchanged. The remaining indicators reflect the 
final contents of the register. 





cnt1 6, reg 
reg, reg 





Before the shift, register 5 contains: 





on 


shift, register 5 contains: 
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Shift Right Arithmetic Double (SRAD) 


Indicators 
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This instruction shifts the contents of a register pair to the right by a specified number of 
bits. The original high-order bit of the register pair is propagated through the vacated 
high-order bits. 


The carry and overflow indicators are unchanged. The remaining indicators reflect the 
final contents of the register pair. 





cnt31, reg 
reg, reg 





SRAD Example 


Shift Right Logical (SRL) 


Indicators 


SRL Example 


Assume that register 1 contains X‘0018’. 
Before the shift, the register pair R7, RO contains: 


R7 RO 





This instruction shifts the contents of a register to the right by a specified number of bits. 
The vacated high-order bits of the register are filled with zeros. 


The carry and overflow indicators are unchanged. The remaining indicators reflect the 
final contents of the register. 





cnt16, reg 
reg, reg 





Before the shift, register 5 contains: 
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Shift Right Logical Double (SRLD) 


Indicators 


SRLD Example 
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This instruction shifts the contents of a register pair to the right by a specified number of 
bits. The vacated high-order bits of the register pair are filled with zeros. 


cnt31, reg 
reg, reg 








[label] SRLD 


The carry and overflow indicators are unchanged. The remaining indicators reflect the 
final contents of the register pair. 
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In this example, assume that register 1 contains X‘0018’. 
Before the shift, the register pair R7, RO contains: 


RO 
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STACK INSTRUCTIONS 
Store Multiple (STM) 


Indicators 


STM Example 


STM saves the contents of one or more general-purpose registers from your main routine. 
Code it at the beginning of a subroutine. 


In the first operand, code a register n. STM stores register 7, then registers 0 through n. 
For example, if you code register 2, STM stores registers 7, 0, 1, and 2. If you code 
register 7, SIM stores register 7 only. 

In the second operand, specify the address of the stack control block that points to the 
stack where you want the registers stored. 

Use the optional third operand to define the size, in bytes, of a work storage area 
within the stack. For abcnt, code the size of the work area. That amount must be an even 
number in the range 0O—16382. 

After it stores the registers and reserves the work area, STM loads reg (the first operand) 
with the address of the low-storage end of the element just placed on the stack—the value 
of the new Top Element Address, plus 2. 





reg, addr4[,abcnt] 





All indicators are unchanged. 


+ STH RA (RID 3 


e RI contains the address of a stack control block. 

e The stack now contains 32 bytes of work storage and a 2-byte control word, in 
addition to the 12 bytes required for the registers. 

STM stores registers 7, 0, 1, 2, 3, and 4 in the specified stack, then loads register 4 with 

the address of the stack control word. The address of the first word of the work 

storage area is contained in register 4. 
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Load Multiple and Branch (LMB) 


This instruction is useful when a subroutine passes control back to your main program. 
At the end of the subroutine, LMB reloads the registers from a stack, then branches to 
the address in register 7. 


jm fom fe 


Before it gave control to the subroutine, the main program loaded register 7 with the 
address that will gain control when the subroutine finishes. This address is usually the 
address of the next sequential instruction following the branch to the subroutine. 

After the main program passed control to the subroutine, the subroutine saved the 
contents of the index registers in a stack (with a STM instruction). 









Indicators 
All indicators are unchanged. 


LMB Example 


Assume that register 1 contains the address of the stack control block that points to the 
stack where the registers are stored. LMB reloads the registers from the stack, and passes 
control to the address in register 7. 


Coding Pop /Push Instructions 


In general, a push instruction moves an element from a register to a stack, and a pop 
instruction moves an element from a stack to a register. 

For the stack operand (addr4) in a push or pop instruction, code the address of the 
stack control block that points to the stack you want to use. 

For the register operand (reg) in a push or pop instruction, code the register you want 
to use. If you code a doubleword instruction (PD or PSD), the register you code is the 
first register of a pair. Note that if you code register 7 as the first register of a pair, the 
instruction uses registers 7 and 0. 


Pop Byte (PB) 


This instruction moves a byte from a stack and places it into a register. 


PB moves the top byte in the stack into bits 8—15 of reg. Bits O—7 of reg are unchanged. 
After PB executes, the Top Element Address pointer in the stack control block points 
to the next byte to be popped from the stack. 









Indicators 
All indicators are unchanged. 
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PB Example 


Pop Doubleword (PD) 


Indicators 


PD Example 


PB (RI) ,R3 


In this example, register 1 contains the address of a stack control block. PB moves the top 
byte from the stack into bits 8—15 of register 3. Bits O—7 of register 3 are unchanged. 
After this PB executes, the Top Element Address pointer is updated and points to the 
next byte to be popped. 


This instruction moves a doubleword from a stack and places it into a pair of registers. 


PD moves the top doubleword in the stack into the register pair specified by reg. 
After PD executes, the Top Element Address pointer in the stack control block points 
to the next doubleword to be popped from the stack. 





All indicators are unchanged. 


PD (RI),R3 


In this example, register 1 contains the address of a stack control block. PD moves the 
top doubleword from the stack into registers 3 and 4. After PD executes, the Top 
Element Address pointer is updated and points to the next doubleword to be popped. 


PD STACKSI,R7 


In this example, STACKO1 is the address of a stack control block. PD moves the top 
doubleword from the stack into registers 7 and 0. After PD executes, the Top Element 
Address pointer is updated and points to the next doubleword to be popped. 
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Pop Word (PW) 


Indicators 


PW Example 


Push Byte (PSB) 


Indicators 


PSB Example 
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This instruction moves a word from a stack and places it into a register. 


PW moves the top word in the stack into reg. 
After PW executes, the Top Element Address pointer in the stack control block points 
to the next word to be popped from the stack. 





All indicators are unchanged. 


PW (RI) RS 


In this example, register 1 contains the address of a stack control block. PW moves the 
top word from the stack into register 5. After this PW executes, the Top Element Address 
pointer is updated and points to the next word to be popped. 


This instruction moves a byte from a register and places it into a stack. 


PSB moves bits 8—15 from the reg into the stack; reg is unchanged. 
After PSB executes, the Top Element Address pointer in the stack control block points 
to the byte just pushed into the stack. 





All indicators are unchanged. 


PSB R2,(R1) 


In this example, R1 contains the address of a stack control block. PSB pushes bits 8—15 
from R2 into the stack. After this PSB executes, the Top Element Address pointer is 
updated, and points to the byte just pushed into the stack. R2 is unchanged. 


Push Doubleword (PSD) 


Indicators 


PSD Example 


Push Word (PSW) 


Indicators 


PSW Example 


This instruction moves a doubleword from a register pair and places it into a stack. 


After PSD executes, the Top Element Address pointer in the stack control block points 
to the doubleword just pushed into the stack. The register pair is unchanged. 









All indicators are unchanged. 


PSD R5, (RI) 


In this example, R1 contains the address of a stack control block. PSD pushes the 
contents of registers 5 and 6 into the stack. After this PSD executes, the Top Element 
Address pointer is updated, and points to the doubleword just pushed into the stack. R5 
and R6 are unchanged. 


This instruction moves a word from a register and places it into a stack. 


After PSW executes, the Top Element Address pointer in the stack control block points 
to the word just pushed into the stack. The register is unchanged. 









All indicators are unchanged. 


— PSW RA, (RI). 


In this example, R1 contains the address of a stack control block. PSW pushes the 
contents of R4 into the stack. After this PSW executes, the Top Element Address pointer 
is updated, and points to the word just pushed into the stack. R4 is unchanged. 
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COMPARE INSTRUCTIONS 


Using Compare Instructions 
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For a compare instruction, you code two operands. The operands are compared, and 
indicators are set to reflect the result. Results of the compare can be tested arithmetically 
or logically. Both operands remain unchanged. 


Note. A compare operation actually subtracts the first operand from the second, then sets 
indicators to reflect the result. Both operands are unchanged. The result is expressed in 
terms of the second operand relative to the first; for example, arithmetically greater than 
means that the second operand is greater than the first. 

An arithmetic test looks at the value of each operand, while a logical test looks for the 
Operand with the most significant bit ON. For example, code a compare with the 
operands A,B. Assume that the value of A is —31, and the value of B is +57. An arithmetic 
test would look at the values and determine that B<A. A logical test would look at the 
individual bits: 


—31=1110 0001 
+57 =0011 1001 


Because —31 (the A value) has its most significant bits ON, the logical test determines that 
B<A. 


You can interpret a compare instruction as either arithmetic or logical, depending on 
the indicators you test after it executes. For example, if the operands on a compare 
instruction are A,B, here is how the indicators are set: 


If the result of compare A, B is These indicators are set 


(Arithmetic) 

B=A Z=1 

B#A Z=0 

B<A (N= 1, V =0) or (N=0, V= 1) 

B<A (N = 1, V=0) or (N=0, V=1) or Z=1 
B>A [(N = 1, V=1) or (N=0, V=0)] and Z=0 


B2A (N= 1, V=1) or (N=0, V=0) 


(Logical) 

B>A (C=0,Z=0) 
B2A C=0 

B<A C=1 

B<A C=lorZ=1 





The abbreviations used for the indicators are: 


Z—zero 
N—negative 
V—overflow 
C-—carry. 


Compare Byte (CB) 


Indicators 


CB Example 


This instructions compares: 

e A byte ina register (bits 8—15) to a byte in storage, or 
e A byte in storage to a byte in storage, 

and sets indicators to reflect the result. 


jo fee 


See “‘Using Compare Instructions” for a description of the indicator settings. 





addr4, reg 
addr5, addr4 





CB BYTE+3,R4_ 


Assume that the byte at location BYTE+3 contains X‘02’ and bits 8—15 of register 4 
contain X‘FD’. CB compares the two values, and sets arithmetically less than and logically 
greater than conditions. 


Compare Byte Field Equal and Decrement (CFED) 


This instruction compares successive (right-to-left) bytes in one field to corresponding 
bytes in another field. It compares two bytes at a time until it finds an equal condition 
OR until it has exhausted the length count. 


[label ] CFED (reg), (reg) 





Before coding CFED, code an instruction to load register 7 with the number of bytes in 
each field. Both fields are the same size. (If register 7 contains 0, CFED is treated as a 
no-operation.) 

CFED compares the rightmost byte in the second field to the rightmost byte in the first 
field, and sets indicators to reflect the result. The contents of both registers are decreased 
by 1, and now point to the bytes to the left of the ones just compared. If the two bytes 
were equal, CFED is finished. If they were not equal, the contents of R7 are decreased by 
1, and the next bytes to the left are compared. 
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When CFED is finished: 


e R7 contains 0 (if CFED found no equal condition) or the number of byte pairs not 
compared, plus 1 (if it found an equal condition). 

e The first operand (reg) points to the byte to the left of the last byte compared in the 
first field. 

e The second operand (reg) points to the byte to the left of the last byte compared in 
the second field. 


Yes 
<> End of CFED 


Compare bytes 
and set indicators 
















Decrease 
addresses of 
byte fields 


Were Yes 
bytes equal End of CFED 


Subtract 1 
from R7 









Indicators 


When CFED is finished, the indicators reflect the result of the last compare. See “Using 
Compare Instructions” for a description of the indicator settings. 
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CFED Example 


CED (R3), (Rg) 


Assume that: 

e R7 contains X‘0003’. 

e The field whose starting address is in R3 contains, in hexadecimal: 
21 21 21 
(R3 points to the rightmost byte). 

e The field whose starting address is in RO contains, in hexadecimal: 
22 23 24 
(RO points to the rightmost byte, X‘24’). 

CFED compares the rightmost byte in the second field, X‘24’, to the rightmost byte in 
the first field, X‘21’. RO and R3 are decreased by 1, and now point to the next bytes to 
the left (RO points to X‘23’ and R3 points to X‘21’). Because the two bytes were not 
equal, register 7 is decreased by 1, and CFED compares X‘23’ to X‘21’. Because there will 
be no equal condition, CFED continues until register 7 contains 0. When CFED is 
finished, RO points to the byte to the left of X‘22’, and R3 points to the byte to the left 
of the leftmost X‘21’. 


Compare Byte Field Equal and Increment (CFEN) 


Indicators 


This instruction compares successive (left-to-right) bytes in one field with corresponding 
bytes in another field. It compares one byte pair at a time until it finds an equal 
condition OR until it has exhausted the length count. 


Code CFEN like CFED, with one exception. Load the registers with the addresses of 
the leftmost bytes in the fields. 

CFEN compares the leftmost byte in the second field to the leftmost byte in the first 
field, and sets indicators to reflect the result. Both registers are increased by 1, and now 
point to the bytes to the right of the ones just compared. If the two bytes were equal, 
CFEN is finished. If they were not equal, register 7 is decreased by 1, and the next bytes 
to the right are compared. When CFEN is finished: 

e R7 contains 0 (if CFEN found no equal condition) or the number of byte pairs not 
compared, plus 1, (if it found an equal condition). 

e The first operand (reg) points to the byte to the right of the last byte compared in the 
first field. 

e The second operand (reg) points to the byte to the right of the last byte compared in 
the second field. 









When CFEN is finished, the indicators reflect the result of the last compare. See “Using 
Compare Instructions” for a description of the indicator settings. 
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CFEN Example 





Assume that: 

e R7 contains X‘000S’. 

© The field whose starting address is in R4 contains, in hexadecimal: 
Fl F3 FS F7 F9 
(R4 points to the leftmost byte, X‘F1’). 

e The field whose starting address is in R3 contains, in hexadecimal: 
Fl F2 F3 F4 F5 
(R3 points to the leftmost byte, X‘F1’). 

CFEN compares the leftmost byte in the second field, X‘F1’, to the leftmost byte in 
the first field, X‘F1’. R3 and R4 are increased by 1, and now point to the next bytes to 
the right (R3 points to X‘F2’ and R4 points to X‘F3’). Because the two bytes were equal, 
CFEN is finished. R7 contains X‘0005’, R4 points to X‘F3’ in the second field, and R3 
points to X‘F2’ in the first field. 


Compare Byte Field Not Equal and Decrement (CF NED) 


Indicators 
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This instruction compares successive (right-to-left) bytes in one field with corresponding 
bytes in another field. It compares one byte pair at a time until it finds a not equal 
condition OR until it has exhausted the length count. 


ei | i 


Code CFNED exactly like CFED. 

CFNED compares the rightmost byte in the second field to the rightmost byte in the 
first field, and sets indicators to reflect the result. Both registers are decreased by 1, and 
now point to the bytes to the left of the ones just compared. If the two bytes were not 
equal, CFNED is finished. If they were equal, register 7 is decreased by 1, and the next 
bytes to the left are compared. When CFNED is finished: 


e R7 contains 0 Gif CFNED did not find a not equal condition) or the number of byte 
pairs not compared, plus 1 (if it found a not equal condition). 

e The first operand (reg) points to the byte to the left of the last byte compared in the 
first field. 

e The second operand (reg) points to the byte to the left of the last byte compared in 
the second field. 





When CFNED is finished, the indicators reflect the result of the last compare. See “Using 
Compare Instructions” for a description of the indicator settings. 


CFNED Example 


~ ENED (RS), (RI) 


Assume that: 

e R7 contains X‘0008’. 

e The field whose starting address is in R5 contains, in hexadecimal: 
02 24 46 68 8A AC CE EO 
(R5 points to the rightmost byte, X‘EO’). 

e The field whose starting address is in R1 contains, in hexadecimal: 
00 00 00 0000 AC CE EO 
(R1 points to the rightmost byte, X‘EO’). 

CFNED compares the rightmost byte in the second field, X‘EO’, to the rightmost byte 
in the first field, also X‘EO’. RS and RI are decreased by 1, and now point to the next 
byte pair to the left. Because the two bytes were equal, register 7 is decreased by 1, and 
CFNED compares the next bytes in the field. CFNED continues until it compares X‘00’ 
(in the second field) to X‘8A’ (in the first field). RS and R1 are decreased by 1, and point 
to the next pair to the left. Because the two compared bytes were not equal, CFNED is 


finished. R7 contains X‘0005’, R5 points to X‘68’ in the first field, and R1 points to 
X‘00’ in the second field. 


Compare Byte Field Not Equal and Increment (CFNEN) 


Indicators 


This instruction compares successive (left-to-right) bytes in one field with corresponding 
bytes in another field. It compares one byte pair at a time until it finds a not equal 
condition OR until it has exhausted the length count. 


co cewen | ep en 


Code CFNEN exactly like CFEN. 
CFNEN compares the leftmost byte in the second field to the leftmost byte in the first 
field, and sets indicators to reflect the result. Both registers are increased by 1, and now 
point to the bytes to the right of the ones just compared. If the two bytes were not equal, 
CFNEN is finished. If they were equal, register 7 is decreased by 1, and the next bytes to 
the right are compared. When CFNEN is finished: | 
e R7 contains 0 (if CFNEN did not find a not equal condition) or the number of byte 
pairs not compared, plus 1 (if it found a not equal condition). 

e The first operand (reg) points to the byte to the right of the last byte compared in the 
first field. 

e The second operand (reg) points to the byte to the right of the last byte compared in 
the second field. 









When CENEN is finished, the indicators reflect the result of the last compare. See “Using 
Compare Instructions” for a description of the indicator settings. 
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CFNEN Example 


Assume that: 
e R7 contains X‘O00D’. 
e The field whose starting address is in R4 contains, in hexadecimal: 

FF FF FF 12 12 12 12 12 12 12 12 12 12 

(R4 points to the leftmost byte,X‘FF’). 
e The field whose starting address is in R1 contains, in hexadecimal: 

12 FF FF FF FF FF FF FF FF FF FF FF FF 

(R1 points to the leftmost byte, X‘12’). 

CFNEN compares the leftmost byte in the second field, X‘12’, to the leftmost byte in 

the first field, X‘FF’. R4 and R1 are increased by 1, and now point to the next bytes to 


the right. Because the two bytes were not equal, CFNEN is finished. R7 contains 
X‘000D’, R1 and R4 point to the bytes to the right of the ones just compared. 


Compare Byte Immediate (CBI) 


Indicators 


CBI Example 
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This instruction compares a specified register to a 1-byte absolute value or expression, 
and sets indicators to reflect the result. 


a ee 


For byte, code an 8-bit value in the range —128 to 127 (arithmetic) or 0 to 255 (logical). 
CBI expands this value to 16 bits by propagating the sign bit to the left of the byte value. 
This value is then used in the comparison. 









See ‘“‘Using Compare Instructions’ for a description of the indicator settings. 


OBL 125 RT 


Assume that R7 contains X‘02A6’. CBI expands X‘7D’ (the equivalent of decimal 125) to 
16 bits by propagating the sign bit (zero) to the left. CBI then compares X‘02A6’ to 
X‘007D’, and sets arithmetically greater than and logically greater than conditions. 


Compare Doubleword (CD) 


Indicators 


CD Example 


Compare Word (CW) 


Indicators 


CW Example 


This instruction compares: 
e A doubleword in a register pair to a doubleword in storage, or 
e A doubleword in storage to a doubleword in storage, 


and sets indicators to reflect the result. 


See “Using Compare Instructions” for a description of the indicator settings. 





addr4, reg 
addr5, addr4 







Assume that: 

e DWORD contains X‘OOE4E1(C0’, and 

e The register pair R2,R3 contains X‘O058F3A66’. 

CD compares the two values, and sets arithmetically greater than and logically greater 
than conditions. 


This instruction compares: 

e A word in a register to a word in a register, 
e A word in a register to a word in storage, or 
e A word in storage to a word in storage, 


and sets indicators to reflect the result. 


reg, reg 
addr4, reg 
addr5, addr4 






See “Using Compare Instructions” for a description of the indicator settings. 





| oF Mono, 


Assume that WORD contains X‘369C’ and register 3 contains X‘OD02’. CW compares the 
two values, and sets arithmetically less than and logically less than conditions. 
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Compare Word Immediate (CWI) 


Indicators 


CWI Example 


This instruction compares: 


e A word in a register to a 1-word absolute value or expression, or 
e A word in storage to a 1-word absolute value or expression, 


and sets indicators to reflect the result. 


jam fom 


See “Using Compare Instructions” for a description of the indicator settings. 





word, reg 
word, addr4 










The immediate word value is equal to X‘FD02’. Assume that register 0 contains X‘369C’. 
CWI compares the values, and sets arithmetically greater than and logically less than 
conditions. 


Scan Byte Field Equal and Decrement (SFED) 


Indicators 
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This instruction compares successive bytes in a field (right-to-left) to a byte in a register 
until it either finds an equal condition or exhausts the length count. 


Before coding SFED, code instructions to: 
e Load register 7 with the number of bytes in the field to be scanned. 
e Load reg so that bits 8—15 of the register contain the byte that the field. is to be 
scanned for. 
e Load the (reg) register with the address of the rightmost byte in the field to be 
scanned. 





SFED compares the rightmost byte in the field to the reg byte, and sets indicators to 
reflect the result. The (reg) register is decreased by 1, and now points to the byte to the 
left of the one just compared. If the two bytes were equal, SFED is finished. If they were 
not equal, register 7 is decreased by 1, and the next byte is compared. 


When SFED is finished, the indicators reflect the result of the last compare. See “Using 
Compare Instructions” for a description of the indicator settings. 


SFED Example 


SFED R2,(Rh) 


Assume that: 


e Register 7 contains X‘0003’, the size of the byte field to be scanned. 
e Bits 8—15 of register 2 contain X‘6D’, the byte to be compared to the field. 
e The contents of the byte field defined by register 4 are, in hexadecimal: 

A4 6D 53 

where R4 points to the rightmost byte in the field (X‘53’). 

SFED compares X‘53’ to X‘6D’, then decreases R4 by 1. Because the two bytes were 
not equal, SFED decreases R7 by 1. Now, R4 points to the next byte to the left of the 
one just compared, and R7 contains X‘0002’, the number of bytes yet to be compared. 
SFED compares the byte in the field (X‘6D’) to the R2 byte (X‘6D’), and again decreases 
R4 by 1. Because the two bytes were equal, SFED is done. R4 points to X‘A4’, and R7 
contains X‘0002’. 


Scan Byte Field Equal and Increment (SFEN) 


Indicators 


SFEN Example 


This instruction compares successive bytes in a field (left-to-right) to a byte in a register 
until it either finds an equal condition or exhausts the length count. 


[label] SFEN reg, (reg) 





Before coding SFEN, code instructions to: 


e Load register 7 with the number of bytes in the field. 

e Load reg so that bits 8—15 of the register contain the byte that the field is to be 
scanned for. 

e Load the (reg) register with the address of the leftmost byte in the field. 

SFEN compares the leftmost byte in the field to the reg byte, and sets indicators to 
reflect the result. The (reg) register is increased by 1, and now points to the byte to the 
right of the one just compared. If the two bytes were equal, SFEN is finished. If they 
were not equal, register 7 is decreased by 1, and the next byte is compared. 


When SFEN is finished, the indicators reflect the result of the last compare. See “Using 
Compare Instructions” for a description of the indicator settings. 


SFEN R5,(R1) 


Assume that: 


e Register 7 contains X‘0005’, the size of the byte field to be scanned. 
e Bits 8—15 of register 5 contain X‘00’, the byte to be compared to the field. 
e The contents of the byte field defined by register 1 are, in hexadecimal: 


10 83 BS 4A FF 
where R1 points to the leftmost byte in the field (10). 
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SFEN compares X‘10’ to X‘00’, then increases R1 by 1. Because the two bytes were 
not equal, SFEN decreases R7 by 1. Now, R1 points to the next byte to the right of the 
one just compared, and R7 contains X‘0004’, the number of bytes yet to be compared. 
Because no byte in the field is equal to the byte in RS, SFEN compares until it exhausts 
the field. When SFEN is finished, R1 points to the byte to the right of X‘FF’. R7 
contains X‘0000’. 


Scan Byte Field Not Equal and Decrement (SFNED) 


Indicators 


SFNED Example 
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This instruction compares successive bytes in a field (right-to-left) to a byte in a register 
until it either finds a not equal condition or exhausts the length count. 


[label] SFNED reg, (reg) 


Code SFNED exactly like SFED. 

SFNED compares the rightmost byte in the field to the reg byte, and sets indicators to 
reflect the result. The (reg) register is decreased by 1, and now points to the byte to the 
left of the one just compared. If the two bytes were not equal, SFNED is finished. If they 
were equal, register 7 is decreased by 1, and the next byte is compared. 





When SFNED is finished, the indicators reflect the result of the last compare. See “Using 
Compare Instructions” for a description of the indicator settings. 


_SFNED R3,(R6) 


Assume that: 


e Register 7 contains X‘0009’, the size of the byte field to be scanned. 
e Bits 8—15 of register 3 contain X‘FF’, the byte to be compared to the field. 
e The contents of the field defined by register 6 are, in hexadecimal: 

FF FF 00 FF FF FF FF FF FF 

where R6 points to the rightmost byte in the field. 


SFNED compares the rightmost byte in the field to the reg byte, then decreases R6 by | 
1. Because the two bytes were equal, SFNED decreases R7 by 1, and compares the next 
byte to the left. SFNED continues until it reaches the byte X‘00’. It compares the reg 
byte to X‘0Q0’, decreases R6 by 1, and, because the two bytes were unequal, SFNED is 
finished. R7 contains x’0003’. 


Scan Byte Field Not Equal and Increment (SFNEN) 


Indicators 


SFNEN Example 


This instruction compares successive bytes in a field (left-to-right) with a byte in a register 
until it either finds a not equal condition or exhausts the length count. 


[label] SFNEN reg, (reg) 


Code SFNEN exactly like SFEN. 

SFNEN compares the leftmost byte in the field to the reg byte, and sets indicators to 
reflect the result. The (reg) register is increased by 1, and now points to the byte to the 
right of the one just compared. If the two bytes were not equal, SFNEN is finished. If 
they were equal, register 7 is decreased by 1, and the next byte is compared. 









When SFNEN is finished, the indicators reflect the result of the last compare. See “Using 
Compare Instructions” for a description of the indicator settings. 


SFNEN RO, (R1) 


Assume that: 

e Register 7 contains X‘0004’. 

e Bits 8—15 of RO contain X‘00’. 

e The byte field defined by R1 contains: 
00 00 00 00 
where R1 points to the leftmost byte. 


Because the reg byte is equal to every byte in the field, SFNEN compares until R7 


contains X‘0000’. When SFNEN is finished, R1 points to the right of the last byte 
compared. 
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LOGICAL INSTRUCTIONS 
AND Word Immediate (NWI) 


Indicators 


NWI Example 


Exclusive OR Byte (XB) 


Indicators 
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This instruction performs an AND operation between an immediate word value and a 
register. 


word, reg/,reg ] 





Note the optional third operand. If you code this third operand, NWI places its result 
into that register, leaving the second operand unchanged. Otherwise, the result is placed 
in the register specified by the second operand. In either case, the word operand remains 
unchanged. 


The carry and overflow indicators are unchanged. The remaining indicators reflect the 
result. 


NWI X"I3AI",R6,R3 


In this example, the immediate value looks like this: 
0001 0011 #1010 #0001 

Assume that register 6 contains: 

0101 1101 1110 = #4111 

The result that NWI places in register 3 is: 

0001 0001 1010 # OOO! 


This instruction performs an exclusive OR between a byte in a register and a byte in 
storage. 


reg, addr4 
addr4, reg 





If you code the reg,addr4 form, XB exclusive ORs bits 8—15 of reg and the byte at 
addr4, placing the result at addr4. The register is unchanged. 

In the addr4,reg form, XB places the result in bits 8—15 of reg, leaving bits O—7 
unchanged. The byte at addr4 is not altered. 


The carry and overflow indicators are unchanged. The remaining indicators reflect the 
8-bit result. 


XB Example 


Assume that the byte at BYTE6 contains: 


0001 1101 

and bits 8—15 of register 3 contain: 

0110 0110 

The result that XB places in bits 8—15 of R3 is: 
0111 1011 


Exclusive OR Doubleword (XD) 


Indicators 


XD Example 


This instruction performs an exclusive OR between a doubleword in a register pair and a 
doubleword in storage. 


cm 


For the reg operand, code the first register of a pair. If you code R3, for example, XD 
uses the register pair R3,R4. If you code R7, XD uses the pair R7,RO. 

XD exclusive ORs the first operand to the second, and places the result in the second 
operand. The first operand remains unchanged. 





reg, addr4 
addr4, reg 







The carry and overflow indicators are unchanged. The remaining indicators reflect the 
32-bit result. 


Assume that the doubleword at DWORD contains: 

0111 1011 OOO! 1101 O110 0110 O111 ~ °#1011 
and the register pair R7,RO contains: 

OOOi 1101 O110 O110 O11 1011 #41011 #1100 
The result that XD places in R7,RO is: 

0110 O110 O111 #©1011 OO01 1101 #=§$1100 += O111 


Machine Instructions 4-97 


Exclusive OR Word (XW) 
This instruction performs an exclusive OR between: 


e A register and a register, or 
e A register and a word in storage. 


reg, reg 

reg, addr4 
XW addr4, reg 

longaddr, reg 


XW exclusive ORs the first operand to the second, placing the result in the second — 
operand. The first operand remains unchanged. | 





Indicators 


The carry and overflow indicators are unchanged. The remaining indicators reflect the 
16-bit result. 


XW Example 





In this example (coded in longaddr,reg form), the first operand is the word whose address 
is the contents of storage at the location defined by register 6. Assume that this word 
contains: | 
0110 0111 #9001 #1100 

and register 0 contains: 

0111 1011 90001 = 1101 

The result that XW places in RO is: 

0001 1100 0000 # £0001 


Exclusive OR Word Immediate (XWI) 


This instruction performs an exclusive OR between a 1-word absolute expression and a 
register. | 


[label] XWI 








word, reg[,reg] 






Note that there is an optional third operand. If you code it, XWI places the result in 
this register, leaving the second operand unchanged. Otherwise, the result is placed in the 
register defined by the second operand. In either case, the word operand remains 
unchanged. | 


Indicators 
The carry and overflow indicators are unchanged. The remaining indicators reflect the 
16-bit result. 
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XWI Example 


Invert Register (VR) 


Indicators 


VR Example 





The immediate value, X‘O6BD’, looks like this: 
0000 0110 1011 ~+#14101 

Assume that R1 contains: 

0110 1001 1000 # OOO] 

The value that XW] places in RS is: 

0110 1111 #0011 °#1100 


This instruction produces the ones complement of the contents of the specified register. 


a ee 


Note the optional second operand. If you code this register, VR places the result (in 
ones complement form) in that register, leaving the first operand unchanged. If you don’t 
code the second operand, VR places the complement back into the source register. 









The carry indicator and overflow indicators are unchanged. The other indicators are 
changed to reflect the result. 


Assume that register 3 contains: 


0011 0100 0101 0110 


0 15 


After execution of VR, register 4 contains: 


1100 1011 1010 1001 


0 15 


Register 3 is unchanged. 
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OR Byte (OB) 


Indicators 


OB Example 


OR Doubleword (OD) 


4-100 
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This instruction performs an OR operation between: 


e A byte in a register and a byte in storage, or 
e A byte in storage and another byte in storage. 


reg, addr4 
addr4, reg 
addr5, addr4 


If you code the reg,addr4 form, OB ORs bits 8—15 of reg.and the byte at addr4, placing 
the result at addr4. The register is unchanged. 

In the addr4,reg form, OB places the result in bits 8—15 of reg, leaving bits O—7 
unchanged. The byte at addr4 is not altered. 

If you code addr5,addr4, the result is placed at addr4, leaving addr5 unchanged. 








The carry and overflow indicators are unchanged. The remaining indicators reflect the 
8-bit result. 


OB (R5)*, (R2)* 


In this example (coded in addr5,addr4 form), the first operand is the byte in storage 
whose address is the contents of storage at the location defined by register 5. Assume that 
this byte contains: 


0111 QOO1 


The second operand is the byte in storage whose address is the contents of storage at 
the location defined by register 2. Assume that this byte contains: 


0001 Q100 
The result that OB places in the byte specified by the second operand is: 
0111 0101 


This instruction performs an OR operation between: 


e A doubleword in a register pair and a doubleword in storage, or 
e A doubleword in storage and another doubleword in storage. 


reg, addr4 
addr4, reg 
addr5, addr4 


For the reg operand, code the first register of a pair. If you code R3, for example, OD 
uses registers 3 and 4. If you code R7, OD uses the pair R7,RO. 

OD ORs the first operand to the second, and places the result in the second operand. 
The first operand remains unchanged. 









Indicators 


OD Example 


OR Word (OW) 


Indicators 


OW Example 


The carry and overflow indicators are unchanged. The remaining indicators reflect the 
32-bit result. 


op (R7), (RI) 


In this example (coded in addr5,addr4 form), the first operand is the doubleword in 
storage whose address is in register 7. Assume that this doubleword contains: 
0110 O110 O111 £1011 £OOO1 1101 $1100 += £4O111 

The second operand is the doubleword in storage whose address is the contents of 
register 1. Assume that this doubleword contains: 
0111 1011 OOO! 1101 O110 O110 O111 #41011 

The result that OD places in the doubleword defined by the second operand is: 
O111 12141 O111 1111 O111) #1111 «81111 «1111 


This instruction performs an OR operation between: 


e A register and a register, 
e A register and a word in storage, or 
e A word in storage and another word in storage. 


reg, reg 
reg, addr4 
addr4, reg 
longaddr, reg 
addr5, addr4 









OW ORs the first operand to the second, and places the result in the second operand. 
The first operand remains unchanged. 


The carry and overflow indicators are unchanged. The remaining indicators reflect the 
result. 


OW (R5,3) ,RA 


In this example (coded in longaddr,reg form), the first operand is the word in storage that 
is 3 bytes past the address specified by register 5. Assume that this word contains: 


Ol1l11 1011 OOO1 1101 
and register 4 contains: 
0001 1100 0000 # £0001 
The result that OW places in register 4 is: 
0111 1111 #OOO1 1101 
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OR Word Immediate (OWI) 


Indicators 


OWI Example 


Reset Bits Byte (RBTB) 


Indicators 
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This instruction performs an OR operation between: 


e A 1-word absolute expression and a register, or 
e A 1-word absolute expression and a word in storage. 


word, reg[,reg] 
word, addr4 








[label] Owl! 






Note the optional third operand in the word,reg,/reg] form. If you code this third 
operand, the result of the OR is placed in the register you code, leaving the second 
operand unchanged. Otherwise, OWI places the result in the register specified for the 
second operand. In either case, the word operand remains unchanged. 

If you code the word,addr4 form, the result is placed in addr4, leaving the word 
operand unchanged. 

Note. The word operand is an absolute value or expression in the range —32768 to 
+32767 or 0 to 65535. 


The carry and overflow indicators are unchanged. The remaining indicators reflect the 
result. 





In this example (coded in word,addr4 form), the immediate value looks like this: 
0001 0011 $1010 #OOO1 

Assume that the word at storage location WORD is: 

0100 O101 O110 O11! 

The result that OWI places in WORD is: 

0101 O111 1110 = O11! 


This instruction operates on a byte, setting specified bits to zero. 


reg, addr4 
[label ] RBTB addr4, reg 
addr5, addr4 


RBTB finds the bits that are on in the byte defined by the first operand. It then turns 
off the corresponding bits in the byte defined by the second operand. The first operand is 
unchanged. 

If you code the reg,addr4 form or the addr4,reg form, RBTB uses bits 8—15 of reg, 
leaving bits O—7 unchanged. 








The carry and overflow indicators are unchanged. The remaining indicators reflect the 
8-bit result. 


RBTB Example 


__RBTB R3,BYTES 


In this example (coded in reg,addr4 form), assume that bits 8—15 of R3 contain: 
0111 0010 

and the byte at BYTES contains: 

0010 1111 


Because the 1, 2, 3, and 6 bits of the R3 byte are on, RBTB turns off the corresponding 
bits in BYTES: 


0000 =«—:1101 


Reset Bits Doubleword (RBTD) 


Indicators 


RBTD Example 


This instruction operates on a doubleword, setting specified bits to zero. 


reg, addr4 
RBTD addr4, reg 
addrS, addr4 


RBTD finds the bits that are on in the doubleword defined by the first operand. It then 
turns off the corresponding bits in the doubleword defined by the second operand. The 
first operand is unchanged. 

For reg, code the first register of a pair. For example, if you code R5, RBTD uses 
registers 5 and 6. If you code R7, RBTD uses the pair R7,RO. 






The carry and overflow indicators are unchanged. The remaining indicators reflect the 
result. 


In this example (coded in addr4,reg form), the location of the doubleword defined by 
addr4 is computed as follows: The contents of R3, added to 48, form an address. The 
contents of storage at that location are added to 4, forming the address of the 
doubleword. Assume that this doubleword contains: 


0011 0101 O110 O11 1111 #©91110 1101 +&#1100 
and the register pair R6,R7 contains: 
0000 60010 0100 0110 1000 1100 1110 += «11411 


RBTD finds the bits that are on in the first operand, and sets the corresponding bits off 
in the second operand. The result that RBTD leaves in R6,R7 is: 


0000 0010 0000 0000 90000 0000 0010 O01! 
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Reset Bits Word (RBTW) 


Indicators 


RBTW Example 


This instruction operates on a word, setting specified bits to zero. 


reg, reg 
reg, addr4 


[label ] RBTW addr4, reg 
longaddr, reg 
addr5, addr4 





RBTW finds the bits that are on in the word defined by the first operand. It then turns 
off the corresponding bits in the word defined by the second operand. The first operand 
is unchanged. 


The carry and overflow indicators are unchanged. The remaining indicators reflect the 
result. 


BTW (R6,36)*, (R2)+ 


In this example (coded in addr5,addr4 form), the location of the word defined by addrS5 
is computed as follows: The contents of R6, plus 36, form an address. The contents of 
storage at that location are the address of the word. Assume that this word contains: 
0000 0100 O101 + = O11! | 

The second word is at the address defined by the contents of R2. (After RBTW, R2 is 
increased by 2, the number of bytes addressed by this instruction.) Assume that this word 
contains: 
1100 1111 #411011 0001 

The result that RBTW leaves in the second operand is: 
1100 1011 1010 0000 


Reset Bits Word Immediate (RBTWI) 
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This instruction operates on a word, setting to zero the bits specified by an immediate 
value. 


word, addr4 
word, reg[,reg] 








[label ] RBTWI 


RBTWI finds the bits that are on in the immediate value defined by the word operand. 
It then turns off the corresponding bits in the word defined by the second operand. The 
first operand remains unchanged. 

Note the optional third operand in the word,reg/,reg] form. If you code this register, 
RBTWI places the result there, leaving the second operand unchanged. If you do not code 
the third operand, the result is placed in the second operand. 


Indicators 


RBTWI Example 


Test Bit (TBT) 


Indicators 


TBT Example 


The carry and overflow indicators are unchanged. The remaining indicators reflect the 
result. 


RBTW! X'4567' ,RO,RI 


In this example (coded in word,reg/,reg] form), the immediate word value looks like this: 
0100 0101 0110 0111 | 
Assume that RO contains: 
0111 0110 0101 #0100 
The result that RBTWI places in R1 is: 
0011 0010 0001 0000 
The immediate value and RO are unchanged. 


This instruction tests a single bit, and sets an indicator to reflect the result. 


To find the bit to be tested, TBT uses the contents of reg as a byte address, and the 
value of bitdisp as a displacement from the byte address. 
Note. Bitdisp must be in the range 0—63. 
Here is what TBT does: 
e It turns off the zero and negative indicators, then 
e It tests the specified bit. 
e If the bit is zero, TBT turns on the zero indicator; if the bit is one, TBT turns on the 
negative indicator. 





(reg, bitdisp) 





The zero and negative indicators reflect the result of the test. The remaining indicators 
are unchanged. 


TBT (R7,3) 


Assume that: 

e R7 contains X‘0420’. 

e The byte at address 0420 contains: 
0000 1111 


TBT turns off the zero and negative indicators, then tests bit number 3 (the fourth bit 
in the byte). Because the bit is zero, TBT turns on the zero indicator. 
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Test Bit and Invert (TBTV) 


Indicators 


TBTV Example 


Test Bit and Reset (TBTR) 


Indicators 
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This instruction tests a single bit, and sets an indicator to reflect the result. After setting 
the appropriate indicator, TBTV unconditionally inverts the tested bit. 


[label] TBTV 


TBTV computes the address of the bit in the same way as TBT, and follows the same 
procedure for testing the bit and setting the indicator. 





(reg, bitdisp) 





The zero and negative indicators reflect the result of the test. The remaining indicators 
are unchanged. 


“TRTV (R7,3) 


Assume that: 


e R7 contains X‘0420’. 
e The byte at address 0420 contains: 


0000 1111 


TBTV turns off the zero and negative indicators, then tests bit number 3 (the fourth bit 
in the byte). Because the bit is zero, TBTV turns on the zero indicator. TBTV inverts the 
tested bit, and the byte now looks like this: 


0001 1111 


This instruction tests a single bit, and sets an indicator to reflect the result. After setting 
the appropriate indicator, TBTR unconditionally sets the tested bit to zero. 


sa = 


TBTR computes the address of the bit in the same way as TBT, and follows the same 
procedure for testing the bit and setting the indicator. 





(reg, bitdisp) 





The zero and negative indicators reflect the result of the test. The remaining indicators 
are unchanged. 


TBTR Example 


Test Bit and Set (TBTS) 


Indicators 


TBTS Example 


Assume that: 
e R2 contains X‘0348’. 
e The byte at address 0348 contains: 
1010 1110 
TBTR turns off the zero and negative indicators, then tests bit number 0 (the first bit in 
the byte). Because the bit is one, TBTR turns on the negative indicator. TBTR sets the 
tested bit to zero, and the byte now looks like this: 


0010 1110 


This instruction tests a single bit, and sets an indicator to reflect the result. After setting 
the appropriate indicator, TBTS unconditionally sets the tested bit to one. 


(reg, bitdisp) 





TBTS computes the address of the bit in the same way as TBT, and follows the same 
procedure for testing the bit and setting the indicator. 


The zero and negative indicators reflect the result of the test. The remaining indicators 
are unchanged. 


— TBTS (R3,5) 


Assume that: 
e R3 contains X‘8680’. 
e The byte at address 8680 contains: 
1101 0010 
TBTS turns off the zero and negative indicators, then tests bit number 5 (the sixth bit 
in the byte). Because the bit is zero, TBTS turns on the zero indicator. TBTS sets the 
tested bit to one, and the byte now looks like this: 


1101 0110 
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Test Word Immediate (TWI) 


This instruction tests specified bits within a word, and sets an indicator to reflect the 
result. 


For the word operand, code a 1-word mask. TWI finds the bits that are on in the mask 
and tests the corresponding bits in the word defined by the second operand. TWI clears 
the zero and negative result indicators, then sets them as follows: 

e If the mask bits OR all of the tested bits are zeros, TWI turns on the zero indicator. 

e If all the tested bits are ones, TWI turns on the negative indicator. 

e If the tested bits are a combination of zeros and ones, TWI sets no indicators (sets a 
positive condition). 





word, reg 
word, addr4 





Indicators 


The even, carry, and overflow indicators are unchanged. The remaining indicators reflect 
the result. 


TWI Example 


TWI X'13Al',R4 


The word mask looks like this: 

0001 0011 1010 #0001 

Assume that R4 contains: 

1011) O111 #1110 0001 

Because all the tested bits are ones, TWI turns on the negative indicator. 
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PROCESSOR STATUS INSTRUCTIONS 
Copy Level Status Register (CPLSR) 


Indicators 


CPLSR Example 


Set Indicators (SEIND) 


Indicators 


This instruction loads the contents of the current Level Status Register (LSR) into a 
specified register. 


Note. For information about the contents of the LSR see Chapter 3 of this manual. 





All indicators are unchanged. 


: -CPLSR RS = 


The contents of the LSR are placed in R5, and the LSR remains unchanged. 


This instruction stores the contents of bits O—4 of a specified register into the result 
indicators in the Level Status Register (bits O—4). 


[label] SEIND 





SEIND stores bits O—4 of reg into the even, carry, overflow, negative, and zero 
indicators. Bits 5—15 of the Level Status Register are unchanged. Bits 5—15 of the 
register are ignored. 


The indicators contain the values specified by bits 0—7 of reg. 
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SEIND Example 


Stop (STOP) 


Indicators 


Supervisor Call (SVC) 


Indicators 


4-110 
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SEIND Rl 


Assume that register 1 contains: 


1101 OO000 1101 #0110 


The result that SEIND places into bits O—4 of the Level Status Register is: 
BitO  even=1 3 

Bit 1 carry=1 

Bit 2 overflow=0 

Bit3 _negative=1 

Bit 4 zero=0 


This instruction causes the processor to enter the stop state. 


For the ubyte operand, you can optionally code a 1-byte unsigned absolute value or 
expression. The processor ignores this value, so you can use it for a flag or indicator. 

For STOP to stop the processor, the processor must have a full-function console, and 
the auto-IPL switch must be in the “Diagnostic Mode” position. Otherwise, STOP is 
executed as a no-operation instruction, causing a branch to the next sequential 
instruction. 





All indicators are unchanged. 


This instruction interrupts the program being executed, then passes control to your 
supervisor or control program routine whose address is in main storage location X‘0012’. 


For the ubyte operand, you can optionally code a 1-byte unsigned absolute value or 
expression. The value is loaded into the low-order byte of R1. The high-order byte of R1 
is set to zero. Control is passed to the address that is in location X‘0012’. For more 
information about supervisor state, see Chapter 3 of this manual or refer to the processor 
description manual for your processor. 





All indicators are unchanged. 


PRIVILEGED INSTRUCTIONS 
Copy Address Key Register (CPAKR) (4955 Processor only ) 


Indicators 


CPAKR Example 


This instruction copies the value in bits O—15 from the Address Key Register(AKR) into 
a storage location or a register. 


a 
reg 


If you code the addr4 operand, CPAKR copies the contents of the AKR into bits O—15 
of this word. 

If you code the reg operand, the contents of the AKR are copied into bits O—15 of the 
specified register. 





All indicators are unchanged. 


—CPAKR R6 


The contents of the AKR are stored in R6, and the AKR remains unchanged. 


Copy Console Data Buffer (CPCON) 


Indicators 


CPCON Example 


This instruction places the contents of the console data buffer into a specified register. 





Notes. 

e If your processor does not have the full-function console, the contents of the register 
are undefined. 

e For information about the console data buffer, refer to the processor description 
manual for your processor. See the Preface of this manual for titles and order 
numbers. 


All indicators are unchanged. 


~ CPCON RS 


The contents of the console data buffer are placed in R5, and the console data buffer 
remains unchanged. 
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Copy Current Level (CPCL) 


Indicators 


CPCL Example 


Copy In-Process Flags (CPIPF) 


Indicators 


CPIPF Example 
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The Copy Current Level (CPCL) instruction loads the current level into the specified 
register. 


All indicators are unchanged. 










“CPC R3 


Assume that your program is currently running on level 1. The value that CPCL places in 
register 3 is X‘0001’. 


This instruction places the value of the in-process flag for each level (bit 9 of each Level 
Status Register) into a word in storage. 


[label] CPIPF addr4 


For addr4, code the address of the word in storage where the in-process flags are to be 
stored. Each bit in the word then corresponds to an interrupt level’s in-process flag. For 
example, bit 0 of the word corresponds to level O—if the in-process flag for level 0 is on, 
CPIPF places a 1 in bit 0 of addr4; if the flag is off, CPIPF places a 0 in bit 0 of addr4. Bit 
1 of addr4 corresponds to level 1, bit 2 corresponds to level 2, and so on. 

Bits corresponding to nonexistent levels are set to zero, and the in-process flags remain 
unchanged. 





All indicators are unchanged. 


—CPIPF (RI) 


Assume that the in-process flags for each level are: 
Level 0 Flag=0 
Level 1 Flag=0 
Level 2 Flag=1 
Level 3 Flag=0 


The result that CPIPF leaves in the word (whose address is in register 1) is: 
0010 0000 0000 0000 


Copy Instruction Space Key (CPISK) (4955 Processor only) 


This instruction copies the instruction space Key field (bits 13—15) within the Address 
Key Register (AKR) into bits 13—15 of either a word in storage or a register. Bits O—12 
are set to zero. 


name | operon | Opemmd 


reg 


If you code the addr4 operand, CPISK copies the contents of bits 13—15 from the AKR 
into bits 13—15 of a word in storage defined by addr4. 
If you code the reg operand, CPISK copies the contents of bits 13—15 into the specified 


register. 





Indicators 
All indicators are unchanged. 


CPISK Example 


“CPISK RA 


Assume the AKR contains X‘0112’: 


0000 0001 0001 0010 


0 15 


After execution of CPISK register 4 contains: 


0000 0000 0000 0010 


0 15 


The instruction space key field is copied into bits 13—15, and bits OQ—12 are set to zero. 
The AKR remains unchanged. 


Copy Interrupt Mask Register (CPIMR) 


This instruction places the contents of the Interrupt Mask Register into a word in storage. 


| Name | operon | Onemmd 


Each bit of the Interrupt Mask Register corresponds to an interrupt level; for example, 
bit 3 corresponds to level 3. Bits corresponding to nonexistent levels are always zero. 
CPIMR leaves the Interrupt Mask Register unchanged. 





Indicators 
All indicators are unchanged. 
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CPIMR Example 
Teal Gad 


In this example, CPIMR places the contents of the Interrupt Mask Register into the word 
whose address is the contents of storage at the location defined by register 3. 


Copy Level Status Block. (CPLB) . 


This instruction places the contents of a specified Level Status Block into a 22-byte 
storage area that you define. 


[label] CPLB reg, addr4 


The reg operand defines the interrupt level whose Level Status Block is to be copied. 
Load this register so that the level is specified in bits 12—15, with bits OQ—11 containing 
zeros. CPLB ignores bits corresponding to nonexistent levels. 

The addr4 operand defines the first word of a 22-byte (11-word) storage area where the 
Level Status Block is to be stored. CPLB stores the Level Status Block in the following 
format: 





Main storage 
address 
(LSB pointer) 





0 15 
*4955 Processor only 













+14 (Hex) 


The Level Status Block remains unchanged. 


Indicators 


All indicators are unchanged. 
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CPLB Example 


~EPLB R6,BLOCK2 | 


Assume that register 6 contains X‘0002’. CPLB places the Level Status Block for 
interrupt level 2 into the 22-byte storage area that begins at BLOCK2. 


Copy Operand!I Key (CPOOK) (4955 Processor only ) 


Indicators 


CPOOK Example 


This instruction copies the operand 1 key field (bits 5—7) within the Address Key 
Register (AKR) to bits 13—15 of either a word in storage or a register. 


Name | opertion | Opemmd 


reg 


If you code the addr4 operand, CPOOK copies the contents of bits 5—7 from the AKR 
into bits 13—15 of the word defined by addr4. 

If you code the reg operand, CPOOK copies the contents of bits 5—7 from the AKR 
into bits 13—15 of the specified register. 









All indicators are unchanged. 


Assume that the AKR contains X‘0120’: 


0000 0001 0010 0000 


0 15 


After execution of CPOOK, register 4 contains: 


0000 0000 0000 0001 


0 15 


The operand 1 key field has been copied into bits 13-15 while bits O—12 have been set 
to zero. The AKR remains unchanged. 


Machine Instructions 4-115 


Copy Operand2 Key (CPOTK ) (4955 Processor only ) 


This instruction copies the operand 2 key field (bits 9—11) within the Address Key 
Register (AKR) into bits 13—15 of either a word in storage or a register. 


addr4 
reg 






[label ] CPOTK 


If you code the addr4 operand, CPOTK copies the contents of bits 9—11 from the AKR 
into bits 13—15 of the word defined by addr4. 

If you code the reg operand, CPOTK copies the contents of bits 9-11 from the AKR 
into bits 13—15 of the specified register. 


Indicators 
All indicators are unchanged. 


CPOTK Example 


CPOTK RA 


Assume that the AKR contains X‘0120’: 


0000 0001 0010 0000 


0 15 


After execution of CPOTK register 4 contains: 


0000 0000 0000 0010 


0 15 


The operand 2 key field has been copied into bits 3—15 while bits O—12 have been set to 
zero. The AKR remains unchanged. 


Copy Processor Status and Reset (CPPSR) 


This instruction places the contents of the Processor Status Word into a specified word in 
storage. 


CPPSR stores the Processor Status Word in the address specified by addr4. (For the 
format of the Processor Status Word, see “Registers” in Chapter 3.) 
CPPSR resets bits O—12 of the PSW, leaving bits 13—15 unchanged. 
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Indicators 


CPPSR Example 


All indicators are unchanged. 


“CPPSR 126(R2,64)* 


In this example, here is how the address is calculated: The contents of register 2, plus 64, 
form an address. The contents of storage at that location, plus 120, form the address 
where the Processor Status Word is to be stored. 


Copy Segmentation Register (CPSR) (4955 Processor only ) 


Indicators 


CPSR Example 


This instruction places the contents of a specified segmentation register into a 
doubleword in storage. 


For reg, code the register that defines—in the following form—the segmentation register 
whose contents you want to store: 
Bits O—4 the 5 high-order bits of the logical storage address 
Bits 5—7 the address key 
Bits 8—15 Zeros 

For addr4, code the address of the doubleword into which the segmentation register is 
to be stored. CPSR copies the register into the doubleword in the following form: 









Bits O—12 physical segment address 


Bit 13 if 1, the contents of the segmentation register are valid; if 0, any attempt 
to use this register results in program check. 
Bit 14 if 1, the block is read-only; any attempt to write into the block while the 


processor is in problem state results in program check. Bit 14 is ignored 
when the processor is in supervisor state or during a cycle-steal access. 
Bits 15—31 zeros 


CPSR leaves the segmentation register unchanged. 


All indicators are unchanged. 


“CPSR R3,DWORD 


Assume that register 3 contains: 

0110 1100 0000 QO00 

and segmentation register 108 contains: 

1110 0001 41101 0000 

CPSR places the following result into the doubleword at DWORD: 
1110 0001 1101 #=.Q0odd0 QO000 0000 0000 = 000 
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Copy Storage Key (CPSK) (4955 Processor only ) 


Indicators 


CPSK Example 


Diagnose (DIAG) 
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This instruction places the contents of a specified storage key into a byte in storage. 


For protection purposes, storage is divided into blocks of 2048 bytes. Each block has 
associated with it a storage key register. 
The reg operand defines the general purpose register that contains, in the following 
form, the number of the storage key register to be copied: 
Bits O—4 the block number in main storage (O—31) 
Bits 5—15 zeros 
CPSK places the storage key into the byte at addr4, in the following form: 
Bits O—3 Zeros 
Bits 4—6 the value of the storage key 
Bit 7 read-only bit 
The storage key remains unchanged. 





All indicators are unchanged. 


Assume that R4 contains: 
1010 1000 0000 #0000 


Because bits 0O—4 of R4 contain X‘15’, CPSK copies the storage key register for block 21. 
Assume that the value of this key is 4 and the read-only bit is on. CPSK places X‘05’ into 
the byte at KEY. 

The storage key register and register 4 remain unchanged. 


This machine-dependent instruction controls and tests various hardware functions. It is 
not intended for use in problem programs or supervisor programs. 


[label } DIAG ubyte 





For the specific meaning of the ubyte field, and for a discussion of the instruction’s 
diagnostic functions, refer to the processor description manual for your processor. See 
the Preface of this manual for titles and order numbers. 


Disable (DIS) 


Indicators 


DIS Example 


This instruction disables: 


e Storage protection, 

e Equate operand spaces, 

e Address translator, or 

e Summary mask, 

depending on the value you specify for a 1-byte mask. 


pee fs fe 


The mask has the following format: 









Bits O—3 unused, must be coded as zeros 

Bit 4 storage protection 

Bit 5 equate operand spaces 

Bit 6 address translator—this bit is ignored if the translator is not fitted on your 
system. 

Bit 7 summary mask 

Notes. 


e On the 4953 Processor, bits O—6 of the mask are not used. 
e This instruction is not interruptible. 


All indicators are unchanged. 





In this example, bits 4 and 7 of the DIS mask are ON; storage protection and the 
summary mask are disabled. 
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Enable (EN) 


Indicators 


EN Example 


The Enable (EN) instruction enables: 


e Storage protection, 

e Equate operand spaces, 
e Address translator, or 
e Summary mask, 


depending on the value you specify for a 1-byte mask. 


The mask has the following format: 





Bits O—3 unused, must be coded as zeros 

Bit 4 storage protection 

Bit 5 equate operand spaces 

Bit 6 address translator—this bit is ignored if the translator is not fitted on your 
system. 

Bit 7 summary mask 


Note. On the 4953 Processor, bits O—6 of the mask are not used. 


All indicators are unchanged. 





In this example, bit 5 of the EN mask is ON; equate operand spaces is enabled. 


Interchange Operand Keys (IOPK) (4955 Processor only ) 


This instruction interchanges the contents of operand 1 key and operand 2 key in the 
Address Key Register. 


Indicators 


IOPK Example 
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Note. For information about the contents of the Address Key Register see “IBM.4955 
Processor and Processor Features Description,” GA34-0021. 





All indicators are unchanged. 


Assume that the AKR contains X‘0120’. After execution of IOPK, the AKR would 
contain X‘0210’. 


Level Exit (LEX) 


Indicators 


LEX Example 


Operate I/O (IO) 


Indicators 


This instruction causes the processor to exit the current level. 


pawn um fm 


For the ubyte operand, you can optionally code a 1-byte unsigned absolute value or 
expression. The processor ignores this value, so you can use it for a flag or indicator. 
LEX does one of two things: 


e If no interrupts are pending, it places the processor into wait state. 
e If there are interrupts waiting, the one with the highest priority is given control. 









All indicators are unchanged. 


Assume that the processor encountered this LEX while it was running on level 0, and 
there are interrupts waiting on levels 1 and 3. The processor exits level 0, and begins 
servicing the first interrupt for level 1. 


This instruction initiates input/output operations from the processor. 


For the longaddr operand, code the address of the Immediate Device Control Block 
(IDCB) that defines the I/O operation you want to perform. 

Appendix K of this manual is a reference aid for coding the IO instruction. For a 
detailed discussion of the IDCB, refer to the processor description manual for your 
processor. See the Preface of this manual for titles and order numbers. 









This instruction sets a condition code using the even, carry, and overflow indicators. See 
“Other Uses of Indicators” in Chapter 3 of this manual. 
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Set Address Key Register (SEAKR) (4955 Processor only ) 


This instruction sets a specified value in the Address Key Register (AKR) (bits 0O—15) 
from a storage location or a register. 


reg 


If you code the addr4 operand the SEAKR instruction loads the contents of this word 
into bits O—15 of the AKR. 

If you code the reg operand the contents of the specified register are placed in bits 
O—15 of the AKR. 









Indicators 
All indicators are unchanged. 


SEAKR Example 





Assume that R2 contains X‘1030’: 


0001 0000 0011 0000 


0 15 
After execution of SEAKR the AKR contains: 


0001 0000 0011 0000 


0 15 


Register 2 remains unchanged. 


Set Console Data Lights (SECON) 


This instruction places the contents of a specified register into the console data lights. 


Note. If your processor does not have the full-function console, SECON is treated as a 
no-operation. 





Indicators 


All indicators are unchanged. 
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Set Instruction Space Key (SEISK) (4955 Processor only ) 


Indicators 


SEISK Example 


This instruction sets the instruction space key field (bits 13—15) within the Address Key 
Register (AKR) from the contents of the word (bits 13—15) defined by the addr4 or reg 


operand. | 





: reg 


If you code the addr4 operand the SEISK instruction loads bits 13—15 of this word into 
bits 13—15 of the AKR. 

If you code the reg operand bits 13—15 of the specified register are placed in bits 
13—15 of the AKR. 





All indicators are unchanged. 


SEI SK Ra 


Assume that R4 contains X‘0002’: 


0000 0000 0000 0010 


0 15 


After execution of SEISK bits 13—15 of the AKR contain: 


XXXX XXXX XxXxx x010 


0 15 


Bits O—12 remain unchanged. Register 4 also remains unchanged. 


Set Interrupt Mask Register (SEIMR) 


This instruction loads the Interrupt Level Mask Register from a word in storage. 


For addr4, code the address of the location that contains the value to be loaded into 
the Interrupt Level Mask Register. 

Each bit in the register corresponds to an interrupt level—bit 0 corresponds to level 0, 
bit 1 corresponds to level 1, and so on. If the bit for a given level is 1, that level is enabled 
and can accept interrupts. 

SEIMR leaves the word in storage unchanged. 


Note. Set to zero any bits that correspond to nonexistent interrupt levels. 
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Indicators 


SEIMR Example 


Set Level Status Block (SELB) 
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All indicators are unchanged. 


-SEINR (R2). 


In this example, assume that the word whose address is in R2 contains: 
1011 0000 0000 0000 


SEIMR loads this value into the Mask Register, leaving the word in storage unchanged. 
Now levels 0, 2, and 3 can accept interrupts. All other levels are disabled. 


This instruction loads a specified Level Status Block from a 22-byte storage area that you 


define. 


[label } SELB reg, addr4 


The reg operand defines the interrupt level whose Level Status Block is to be loaded. 
Load reg so that the level is specified in bits 12 through 15, with bits 1—11 containing 
zeros. Bit O is the inhibit-trace-interrupt bit. SELB ignores bits that correspond to 
nonexistent levels. 

The addr4 operand defines the first word of a 22-byte (11-word) storage area that is to 
be loaded into the Level Status Block. The storage area has the following format: 









Main storage 
address 
(LSB pointer) 





0 15 

















+14 (Hex) 


*4955 Processor only 


The 22-byte storage area remains unchanged. 


Note. If this instruction turns off bit 8 of the Level Status Register, the processor leaves 
supervisor state. This instruction is the only way to exit supervisor state. 


Indicators 


SELB Example 


The indicators reflect the contents of the LSR that this instruction loaded into word 2 of 
the Level Status Block. 


SELB R4,BLOCK3 


Assume that R4 contains X‘0003’. SELB places the contents of the 22-byte storage area 
that begins at BLOCK3 into the Level Status Block for level 3. If, in the LSB, the LSR 
trace bit is on, trace interrupts can occur after SELB has executed. 


Set Operand!1 Key (SEOOK) (4955 ‘Processor only ) 


Indicators 


SEOOK Example 


This instruction sets the operand 1 Key field (bits 5—7) within the Address Key Register 
(AKR) from the contents of the word (bits 13—15) defined by the addr4 or reg operand. 


reg 


If you code the addr4 operand the SEOOK instruction loads bits 13—15 of this word into 
bits 5—7 of the AKR. 

If you code the reg operand bits 13—15 of the specified register are placed in bits 5—7 
of the AKR. 










All indicators are unchanged. 


Assume R3 contains X‘0002’: 


0000 0000 0000 0010 


0 15 


After execution of SEOOK bits 5—7 of the AKR contain: 


XXXxX XO10 XxXXxX XxXxXx 


0 15 


Bits O—4 and 8—15 remain unchanged. Register 3 also remains unchanged. 
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Set Operand2 Key (SEOTK) (4955 Processor only ) 


Indicators 


SEOTK Example 


This instruction sets the operand 2 key field (bits 9-11) within the Address Key Register 
(AKR) from the contents of the word (bits 13—15) defined by the addr4 or reg operand. 


reg 


If you code the addr4 operand the SEOTK instruction loads bits 13-15 of this word into 
bits 9-11 of the AKR. 

If you code the reg operand, bits 13-15 of the specified register are placed in bits 9-11 
of the AKR. 









‘All indicators are unchanged. 


SEOTK RA 


Assume register 4 contains X‘0001’: 


0000 0000 0000 0001 


0 15 


After execution of SEOTK bits 9—11 of the AKR contain: 


XXXX XXXX xQO1 xxxx 


0 15 


Bits O—8 and 12—15 remain unchanged. Register 4 also remains unchanged. 


Set Segmentation Register (SESR) (4955 Processor only ) 
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This instruction places the contents of a doubleword in storage into a specified 
segmentation register. 


For reg, code the register that defines the segmentation register you want to load. See 
CPSR for the form of this register. 

For addr4, code the address of the doubleword whose contents are to be loaded into 
the segmentation register. See CPSR for the form of this doubleword. . 

SESR loads the first 16 bits of the doubleword into the segmentation register, leaving 
the doubleword unchanged. 









Indicators 


SESR Example 


All indicators are unchanged. 


SESR R5,(R3) 


Assume that register 5 contains: 

1100 0011 0000 #0000 

and doubleword whose address is in register 3 contains: 

0010 1111 #0010 0000 Q000 0000 0000 0000 
SESR places the following result into segmentation register 195: 
0010 1111 0010 0000 0000 0000 0000 #0000 


Set Storage Key (SESK) (4955 Processor only ) 


Indicators 


SESK Example 


This instruction places a specified value into a storage key. 


The reg operand defines the general purpose register that contains, in the following 
form, the number of the storage Key register to be loaded: 
Bits O—9 the block number in main storage (O—31) 
Bits 10—15 = zeros 
The value that SESK loads into the storage key is in the following form: 
Bits O—3 Zeros 
Bits 4—6 the value of the storage Key 
Bit 7 read-only bit 
The contents of reg and addr4 remain unchanged. 





All indicators are unchanged. 


SESK R7, (RI) 


Assume that register 7 contains: 

1101 1000 0000 £0000 

Because bits 0O—4 of R7 contain decimal 27, SESK loads the storage key register 27. 
Assume that the byte whose address is in register 1 contains X°07’. SESK loads this 8-bit 
value into storage key 27. The contents of R7, R1, and the byte in storage remain 
unchanged. 
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FLOATING-POINT INSTRUCTIONS (4955 PROCESSOR ONLY) 


Floating-point Number Representation 


4-128 


SC34-0074 


Each floating-point number is represented as a combination of two items: a numeric 
fraction and a power of 16 by which the fraction is multiplied. The power of 16 is called 
the characteristic, by analogy with logarithms. For instance, the number 1 is represented 
by 1/16 x 16'. The 1/16 is stored as a hexadecimal fraction: 0.11, = 1/16. The 
characteristic is written in excess 64 notation, which means that every characteristic is 
64,9 greater than the power actually represented. Thus, the characteristic +1 is 
represented as: 

=1+64 = 6519 = 41ié¢ 

The characteristic —1 becomes: 

—1+64 = 6319 = 3Fig« 

The excess 64 method is used to avoid the need of a sign for the characteristic. 

The processor permits two types of floating-point numbers, called single-precision and 
double-precision. In each, the excess 64 exponent is contained in bits 1—7 of the first 
byte (bit O is the sign of the number). In a single-precision number, the fractional part 
consists of six hexadecimal digits contained in the next three bytes. 


Fraction 


teristic 





In a double-precision number, the fractional part consists of 14 hexadecimal digits 
contained in the next seven bytes. 


Fraction 


Charac- 
teristic 


A single-precision number, therefore, occupies two words, and a double-precision 
number four words. 

The number +3 would be represented as 4130 0000 in (single-precision) floating point, 
and would be stored as: 





4 1 3 0 0 0 0 0 


ho 0001 | 0011 0000 0000 0000 0000 0000 
2 ee "ee 
Characteristic Fraction (3 bytes) 


Sign 


The number —3 would be represented as C130 0000 0000 0000 in (double-precision) 
floating point, and would be stored as: 


I 0 0 0 0 
eee, ee pow pe! pe! ae pe, 


Ts 0001] 0011 0000 0000 0000 0000 0000 


eat it a a el 
Characteristic Fraction (7 bytes) 





Sign 


Here are examples of some single-precision floating-point representations: 





0000 0000 0000 0000 


4120 0000 0000 0000 
4BB3 A73C ESBS 9000 
4019 9999 9999 999A 
C1FO 0000 0000 0000 





When a floating-point number has no leading hexadecimal zeros in its fraction, it is said 
to be normalized. Note that a normalized floating-point number might have as many as 
three leading binary zeros in its fraction. For example, the floating-point number 
4120 0000 is normalized, because the first hexadecimal digit of the fraction (200000) is 
not zero. The binary representation of the first digit of the fraction, however, is 0010, 
which has two leading binary zeros. Define Constant (DC) entries in assembler language 
are always converted to normalized form, and floating-point numbers in storage are 
assumed to be normalized. 

Floating-point representation can express decimal values ranging from about 5.4 x 
10-7? to about 7.2 x 1075. 
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Floating-point Registers and Instructions 


Each interrupt level has four 64-bit floating-point registers, numbered 0, 1, 2, and 3. All 
floating-point arithmetic and compare instructions use at least one of these registers, 
placing results (from arithmetic instructions) in the register defined by the second 
operand. 

The entire set of floating-point instructions is available for both single-precision and 
double-precision operands. When you code a single-precision arithmetic instruction—FA, 
FD, or FS—all operands and results are 32-bit floating-point values. The rightmost 32 bits 
of the floating-point registers do not participate and are unchanged. The product in 
Floating Multiply (FM) is 64 bits, and occupies a full register. When you code a 
single-precision move instruction—-FMV or FMVC-—the rightmost 32 bits of the 
floating-point register are set to zero. When you code a double-precision instruction—such 
as FAD, FDD, or FSD—all operands and results occupy 64 bits. 


Copy Floating Level Block (CPFLB) 


Indicators 


CPFLB Example 


Floating Add (FA) 
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This instruction places the contents of the floating-point registers for a specified level into 
a 32-byte storage area. This is a privileged instruction. 


CPFLB 








reg, addr4 





For reg, code the general-purpose register that contains, in bits 12—15, the interrupt 
level whose floating-point registers you want to store. Bits O—11 of reg must contain 
Zeros. 

For addr4, code the address of the first byte of the 32-byte storage area where the 
registers are to be stored. 

The floating-point registers and reg are unchanged. 


All indicators are unchanged. 


CPFLB R6,FREGS 


Assume that R6 contains X‘0001’. CPFLB copies the contents of the floating-point 
registers for level | into the 32-byte storage area that begins at FREGS. 


This instruction adds two single-precision floating-point values, and places the normalized 
result into a floating-point register. 


freg, freg 
The floating-point value specified by the first operand is added to the contents of the 
freg specified by the second operand. The first operand is unchanged. 






Indicators 


FA Example 


Floating Add Double (FAD) 


Indicators 


FAD Example 


The even, carry, and overflow indicators are reset. The overflow indicator is turned on if 
an underflow or overflow occurs. If there is an underflow, the even indicator is also 
turned on. The carry indicator is reset, and the remaining indicators reflect the result. 


FA FR3,FR¢ 


Assume that: 
e Bits O—31 of FR3 contain 4150 0000 (the floating-point hexadecimal representation 
of decimal 5). 
e Bits O—31 of FRO contain 41C0O 0000 (the floating-point hexadecimal representation 
of decimal 12). 
FA adds the two values, and places 4211 0000 (the floating-point hexadecimal 
representation of decimal 17) into FRO. FR3 is unchanged, and bits 32—63 of FRO 
contain zeros. 


This instruction adds two double-precision floating-point numbers, and places the 
normalized result into a floating-point register. 


addr4, freg 


[label] freg, freg 





The floating-point value specified by the first operand is added to the contents of the 
freg specified by the second operand. The first operand is unchanged. 


The even, carry, and overflow indicators are reset. The overflow indicator is turned on if 
an underflow or overflow occurs. If there is an underflow, the even indicator is also 
turned on. The carry indicator is reset, and the remaining indicators reflect the result. 


_ FAD FLOAT, FR2 


Assume that: 
e The 64 bits at FLOAT contain 41C0O 0000 0000 0000 (the double-precision, 
floating-point, hexadecimal representation of decimal 12). 
° The 64 bits in FR2 contain 422F 0000 0000 0000 (the double-precision, 
floating-point, hexadecimal representation of decimal 47). 
FAD adds the two values, and places 423B 0000 0000 0000 (the double-precision, 
floating-point, hexadecimal representation of decimal 59) into FR2. FLOAT is 
unchanged. 
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Floating Compare (FC) | 
This instruction compares two single-precision numbers, and sets indicators to reflect the 
result. 


FC compares bits 0-31 of the two registers. See “Compare Instructions” for a 
discussion of the compare process. FC leaves both operands unchanged. 





Indicators 
The even, carry, and overflow indicators are reset. If an underflow or overflow occurs, the 
overflow indicator is turned on. If there is an underflow, the even indicator is also turned 
on. The remaining indicators reflect the result. 

FC Example 


FC FRQ,FRI 


Assume that: 


e Bits OQ—31 of FRO contain 41FO 0000, the floating-point equivalent of decimal 15. 
e Bits O—31 of FR1 contain C1FO 0000, the floating-point equivalent of decimal —15. 


FC compares the two values, and sets an arithmetically less than condition. 


Floating Compare Double (FCD) 
This instruction compares two double-precision floating-point numbers, and sets 
indicators to reflect the result. 


[label] FCD freg, freg 





FCD compares the two registers. See “Compare Instructions” for a discussion of the 
compare process. FCD leaves both operands unchanged. 


Indicators 
The even, carry, and overflow indicators are reset. If an underflow or overflow occurs, the 
overflow indicator is turned on. If there is an underflow, the even indicator is also turned 
on. The remaining indicators reflect the result. 

FCD Example 






Assume that: 


e FR3 contains 4211 0000 0000 0000, the floating-point equivalent of decimal 17. 
e FR2 contains 4111 9999 9999 999A, the floating-point equivalent of decimal 1.1. 


FCD compares the two values, and sets an arithmetically less than condition. 
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Floating Diagnose (FDIAG) 


Floating Divide (FD) 


Indicators 


FD Example 


This instruction tests various functions of the floating-point hardware. It is not intended 
for use in problem programs or supervisor programs. 


[label ] FDIAG 





For a discussion of the instruction’s diagnostic functions, see JBM 4955 Processor and 
Processor Features Description, GA34-0021. 


This instruction divides one single-precision floating-point number into another. 


addr4, freg 
freg, freg 





Bits O—31 of the freg defined by the second operand are divided by the 32-bit value 
defined by the first operand. FD places the result into bits O—31 of the second operand, 
leaving the first operand unchanged. Bits 32—63 of the second operand are unchanged. 
FD saves no remainder. 


Note. If you try to divide by zero, neither operand is altered. 


The even, carry, and overflow indicators are reset, then: 


If this occurs: These indicators are turned on: 


Overflow Overflow 


Underflow Overflow & Even 
Attempt to divide by zero Carry & Overflow: 





The remaining indicators are set to reflect the result. 





Assume that: 


e Bits 0O—31 of FR2 contain 4310 2000, the floating-point equivalent of decimal 258. 
e The 32 bits at FLOAT contain 4256 0000, the floating-point equivalent of decimal 
86. 


FD divides: 4310 2000 divided by 4256 0000 = 4130 0000 


(in decimal it would be 258 divided by 86 = 3), and places the result into bits O—31 of 
FR2. Bits 32—63 of FR2 are unchanged. 
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Floating Divide Double (FDD) 


Indicators 


FDD Example 


Floating Move (FMV) 


Indicators 
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This instruction divides one double-precision floating-point number into another. 


addr4, freg 
freg, freg 





The contents of the freg defined by the second operand are divided by the 64-bit value 
defined by the first operand. FDD places the result into the second operand, leaving the 
first operand unchanged. FDD saves no remainder. 


Note. If you try to divide by zero, neither operand is altered. 


See “Indicators”? under FD. 





Assume that: 


e FRO contains 4421 C500 0000 0000, the floating-point equivalent of decimal 8645. 

e FR3 contains 472B 2D30 9000 0000, the floating-point equivalent of decimal 
45,273,865. 

FDD divides: 472B 2D30 9000 0000 divided by 4421 C500 0000 0000 = 

4414 7500 0000 0000 


(in decimal it would be 45,273,865 divided by 8645 = 5237), and places the result into 
FR3. 


This instruction moves a single-precision floating-point number: 


e From storage to bits O—31 of a floating-point register (setting bits 32—63 to zero), 

e From bits 0O—31 of one floating-point register to bits O—31 of another (setting bits 
32—63 of the destination to zero), or 

e From bits O—31 of a floating-point register to a 4-byte storage location. 


addr4, freg 
FMV freg, freg 
freg, addr4 


The even, carry, and overflow indicators are reset. The remaining indicators reflect the 
new contents of the second operand. 









FMV Example 





Assume that: 


e FLOAT contains 4501 3C76. 

e Bits O—31 of FR1 contain 3F3B 249D. 

FMV moves the contents of FLOAT to bits O—31 of FR1. After FMV, both operands 
contain 4501 3C76. Bits 32—63 of FR1 contain zeros. 


Floating Move Double (FMVD) 


Indicators 


FMVD Example 


This instruction moves a double-precision floating-point number: 


e From storage to a floating-point register, 
e From one floating-point register to another, or 
e From a floating-point register to an 8-byte storage location. 


addr4, freg | 
[label] FMVD freg, freg 
freg, addr4 


The even, carry, and overflow indicators are reset. The remaining indicators reflect the 
new contents of the second operand. 








Assume that: 


e FR3 contains 4112 SCE2 3010 0000. 
e FLOAT contains 4200 3458 CDF1 2000. 


FMVD moves the contents of FR3 to FLOAT. After FMVD, both operands contain 
4112 SCE2 3010 0000. 
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Floating Move and Convert (FMVC) 


Indicators 


FMVC Examples 
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This instruction does one of the following: 

e Converts an integer to a single-precision floating-point number, loading it into bits 
O—31 of a floating-point register. 

® Converts a single-precision floating-point number to an integer, placing it into a 1-word 
storage location. 


addr4, freg 
freg, addr4 








[label] FMVC 






If you code the addr4,freg form, FMVC converts the signed, 2-byte integer at addr4 to 
a 32-bit floating-point number, then places it into bits O—31 of freg. Bits 32—63 of freg 
are set to zero. 

If you code the freg,addr4 form, FMVC converts bits 0—31 of the floating-point 
number in freg to a signed 2-byte integer, then stores it at addr4. Any fractional portion 
of the floating-point number is truncated. 

The first operand is unchanged. 


The even, carry, and overflow indicators are reset. If you coded addr4,freg, the remaining 
indicators are set to reflect the new contents of the second operand. If you specified the 
freg,addr4 form, the indicators are set as follows: If the converted number is larger than 
+2!5—1 or less than —2'5, the carry indicator is turned on. In this case, the value stored is 
either the largest (+2'°—1) or the smallest (-2!5) representable number. The remaining 
indicators reflect the new contents of the second operand. 





Assume that the word whose address is in R5 contains X‘0018’ (the equivalent of decimal 
24). FMVC converts this value to floating-point 4218 0000, and places it into bits O—31 
of FR2. Bits 32—63 of FR2 contain zeros. 





Assume that FRO contains 41C0 0000. FMVC converts this value to X‘OOOC’ (the 
equivalent of decimal 12), and places it into the word that is 2 bytes past INT. 


Floating Move and Convert Double (FMVCD) 


Indicators 


FMVCD Examples 


This instruction does one of the following: 

e Converts an integer to a double-precision floating-point number, loading it into a 
floating-point register. 

e Converts a double-precision floating-point number to an integer, placing it into a 
doubleword storage location. 


addr4, freg 
freg, addr4 








[label] FMVCD 









If you code the addr4,freg form, FMVCD converts the signed, 4-byte integer at addr4 
to a 64-bit floating-point number, then places it into freg. 

If you code the freg,addr4 form, FMVCD converts the 64-bit floating-point number in 
freg to a signed 4-byte integer, then stores it at addr4. Any fractional portion of the 
floating-point number is truncated. 

The first operand is unchanged. 


The even, carry, and overflow indicators are reset. If you coded addr4,freg, the remaining 
indicators are set to reflect the new contents of the second operand. If you specified the 
freg,addr4 form, the indicators are set as follows: If the converted number is larger than 
+23*~1 or less than —2°', the carry indicator is turned on. In this case the value stored is 
either the largest (+2°’—1) or the smallest (—2°') representable number. The remaining 
indicators reflect the new contents of the second operand. 





R3 contains the address of a storage location. Assume that the doubleword whose address 
is in that location contains X‘FFFF EFFF’ (the equivalent of decimal —-4097). FMVCD 
converts this value to floating-point C410 0000 0000 000, placing it in FR3. 


eens 





Assume that FRO contains 42FF 0000 0000 0000. FMVCD converts this value to 
X‘OOFF’ (the equivalent of decimal 255), placing it into the storage location whose 
address is in R6. 
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Floating Multiply (FM) 


This instruction multiplies one single-precision floating-point number by another. 





addr4, freg 


The 32-bit value defined by the first operand is multiplied by bits O—31 of the freg 
defined by the second operand. FM places the result into bits O—63 of the second 
operand, leaving the first operand unchanged. 


Indicators 
The even, carry, and overflow indicators are reset. The overflow indicator is turned on if 
an overflow or underflow occurs. If there is an underflow, the even indicator is also 
turned on. The remaining indicators are set to reflect the result. 

FM Example 





Assume that: 


e Bits O—31 of FR1 contain 4120 0000, the floating-point equivalent of decimal 2. 
e Bits O—31 of FR3 contain 4160 0000, the floating-point equivalent of decimal 6. 


FM multiplies the two values, placing the result, 41CO 0000 0000 0000 (the 
floating-point equivalent of decimal 12), in all 64 bits of FR3. FR1 is unchanged. 


Floating Multiply Double (FMD) 


This instruction multiplies one double-precision floating-point number by another. 


addr4, freg 
freg, freg 








[label] FMD 


The 64-bit value defined by the first operand is multiplied by the freg defined by the 
second operand. FMD places the result into the second operand, leaving the first operand 
unchanged. 


Indicators 


The even, carry, and overflow indicators are reset. The overflow indicator is turned on if 
an overflow or underflow occurs. If there is an underflow, the even indicator is turned on. 
The remaining indicators are set to reflect the result. 
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FMD Example 


Floating Subtract (FS) 


Indicators 


FS Example 





Assume that: 


e The 64 bits at FLOAT+4 contain 4219 0000 0000 0000, the floating-point 
equivalent of decimal 25. 
e FR2 contains 4140 0000 0000 0000, the floating-point equivalent of decimal 4. 


FM multiplies the two values, placing the result, 4264 0000 0000 0000 (the 
floating-point equivalent of decimal 100), into FR2. The 64 bits at FLOAT+4 are 
unchanged. 


This instruction subtracts one single-precision floating-point number from another. 


addr4, freg 
freg, freg 








The 32-bit value specified by the first operand is subtracted from bits O—31 of the freg 
defined by the second operand. FS places the normalized result into bits O—31 of the 
second operand, leaving the first operand unchanged. Bits 32—63 of the second operand 
are set to zero. 


The even, carry, and overflow indicators are reset. If an underflow or overflow occurs, the 
overflow indicator is turned on. If there is an underflow, the even indicator is also turned 
on. The remaining indicators reflect the result. 





Assume that: 


e Bits O—31 of FR1 contain 4150 0000, the floating-point equivalent of decimal 5. 
e Bits O—31 of FR2 contain 4211 0000, the floating-point equivalent of decimal 17. 


FS subtracts FR1 from FR2, leaving 41CO 0000 (the floating-point equivalent of 
decimal 12) in FR2. Bits 32—63 of FR2 are unchanged, as is FR1. 
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Floating Subtract Double (FSD) 


Indicators 


FSD Example 


This instruction subtracts one double-precision floating-point number from another. 


freg, freg 
The 64-bit value specified by the first operand is subtracted from the freg defined by 
the second operand. FSD places the normalized result into the second operand, leaving 
the first operand unchanged. 








The even, carry, and overflow indicators are reset. If an underflow or overflow occurs, the 
overflow indicator is turned on. If there is an underflow, the even indicator is also turned 
on. The remaining indicators reflect the result. 





Assume that: 
e FR1 contains 4310 0000 0000 0000, the floating-point equivalent of decimal 256. 
e FR3 contains 4210 0000 0000 0000, the floating-point equivalent of decimal 16. 


FSD subtracts FR1 from FR3, leaving 42FO 0000 0000 0000 (the floating-point 
equivalent of decimal 240) in FR3. FR1 is unchanged. 


Set Floating Level Block (SEFLB) 
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This instruction loads the floating-point registers for a specified level from a 32-byte 
storage area. This is a privileged instruction. 


os SEFLB reg, addr4 


For reg, code the general-purpose register that contains, in bits 12—15, the interrupt 
level whose floating-point registers you want to load. Bits O—11 of reg must contain 
zeros. 

For addr4, code the address of the first byte of the 32-byte storage area that the 
registers are to be loaded from. The contents of the storage location and reg are 
unchanged. 





Indicators 
All indicators are unchanged. 


SEFLB Example 





Assume that RO contains X‘0003’. SEFLB loads the floating-point registers for level 3 
from the 32-byte storage area whose starting address is in register 1. 
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ESTABLISHING SYMBOLIC REPRESENTATION 


Assigning Values to Symbols 


EQU—Equate Symbol 


By assigning an absolute value to a symbol and then using that symbol to represent the 
absolute value, you can code machine instructions entirely in symbolic form. 

Some symbols represent absolute values, while others represent relocatable address 
values. Relocatable addresses are associated with: 
e Instructions 
e Constants 
e Storage areas 


You can use these defined symbols in the operand fields of instruction statements to refer 
to the instruction, constant, or area represented by the symbol. 


The EQU and EQUR instructions assign values to symbols: 


e EQU-—for symbols other than registers 
e EQUR-—for symbols that represent registers 


EQU assigns absolute or relocatable values to symbols. You can use it for the following 
purposes: 


e To assign single absolute values to symbols. 

e To assign the values of previously defined symbols or expressions to new symbols, thus 
allowing you to use different symbolic names for different purposes. 

e To compute expressions whose values are unknown at coding time or difficult to 
calculate. The value of the expression is then assigned to a symbol. 

You can code the EQU instruction anywhere in a source module after any source macro 
definitions you have specified. Note, however, that the EQU instruction initiates an 
unnamed control section (private code) if you code it before the first control section 
(initiated by a START or CSECT instruction). 

The format of the EQU instruction statement is: 


poms |e femme 
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EQUR—Equate Register 
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The label field can contain any ordinary symbol. Expression represents a value. It must 
always be specified and can have a relocatable or absolute value in the range —65536 
through +65535. The assembler maintains this value internally as a signed 32-bit number. 
Only the rightmost 16 bits are used in assembled instructions, or printed in hexadecimal 
notation in the location column of your program listing. 

You must define all symbols appearing in the expressions in previously coded 
instructions—instructions that physically precede this EQU in the source module. 

The assembler assigns an absolute or relocatable value to the symbol in the name field 
(the label) of the EQU instruction. 

The following examples indicate valid EQU statements and the value (absolute or 
relocatable) assigned to the symbol in the label field of each: 


START @ 

OC F433! 

DS XL297 

DS CL249 

DS CL8¢ 

DC A(X,Y,Z) 

EQU  X'FF! ABSOLUTE 
EQU = x+h RELOCATABLE 
EQU = AXIP ABSOLUTE 
EQU FULL RELOCATABLE 
EQU  AREA+I£9 RELOCATABLE 
EQU TO RELOCATABLE 
EQU  FROM-TO ABSOLUTE 
EQU ADCONS RELOCATABLE 
EQU  SECTA RELOCATABLE 
END 


EQUR defines a register symbol (symbol to be used instead of the predefined register 
names) by assigning to the symbol the value of an absolute expression. You can code the 
EQUR instruction anywhere in a source module after the start of the program control 
section and after any other statement that defines symbols used in the absolute 
expression on the EQUR instruction. The EQUR instruction must precede all assembler 
and machine instructions that use the register symbol. 

The format of the EQUR instruction is: 








Defining Data 


DC— Define Constant 


EQUA AtB (ASSUMING A=3 AND B=1, REGH=4,) 


where symbol is an ordinary symbol given the value of the absolute expression (value 
must be in the range 0O—7). Any symbols in the absolute expression must be previously 
defined (defined in statements coded prior to the EQUR instruction). The symbol is 
absolute. 

Note. All register specifications in machine instructions must contain a register symbol, 
which is either one of the predefined register symbols or has been defined in a preceding 
EQUR instruction. These register symbols may only appear in machine or assembler 
instructions as a register specification. 


The following examples indicate valid EQUR instructions: 





This section describes DC and DS instructions, used to define data constants and reserve 
main storage. You can code a label for these instructions and then refer to the data 
constant or storage area symbolically in the operands of machine and assembler 
instructions. The symbol used as a label represents the address of the constant or storage 
area—do not confuse it with the assembled object code for the constant or contents of 
the storage area. This data is generated, and storage is reserved at assembly time and used 
by the machine instructions at execution time. 


DC defines data constants needed for program execution. The DC instruction causes the 
assembler to generate (at assembly time) the binary representation of the data constant 
you specify, storing that value in a particular location in the assembled object module. 
One DC statement can generate a maximum of 256 bytes of data. 

The DC instruction can generate the following types of constants: 
e Binary constants, which define bit patterns 
e Character constants (EBCDIC, ASCII, or PTTC/EBCD), which define character strings 
Or messages 
Hexadecimal constants, which define large bit patterns 
Fixed-point constants, which define fixed-point numeric values 
Floating-point constants, which define floating-point numeric values 
Address constants, which define addresses or values resulting from expression 
evaluation. 


The format of the DC instruction is: 
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The symbol in the name field represents the address of the first word of the assembled 
constant. The operand in a DC instruction consists of 4 subfields. The first 3 subfields 
describe the constant, and the fourth subfield specifies the nominal value of the constant 
to be generated. 


Duplication factor (optional) 


Constant type (required) 
Modifiers (optional) 
Nominal value or values (required) 





Rules for the DC Operand. 


e The type subfield and the nominal value must always be specified. 

e The duplication factor and modifier subfields are optional. 

e When multiple operands are specified, they can be of different types. 

e When multiple nominal values are specified in the fourth subfield, they must be 
separated by commas and be of the same type. The descriptive subfields apply to all 
the nominal values. 

Note. Separate constants are generated for each separate nominal value specified. 

No blanks are allowed in the DC instruction: 


e Between subfields 

e Between multiple operands 

e Within any subfields, unless they occur as part of the nominal value of a C-, P-, or 
S-type character constant, or as part of a character self-defining term in a modifier 
expression or in the duplication factor subfield 

Constants defined by the DC instruction are assembled into an object module at the 

location where the DC instruction is coded. The value of the symbol that names the DC 

instruction is the address of the leftmost byte of the constant. For example, the 

instruction 


Padding and Truncating Constants 


causes the assembler to generate the 6-byte constant 


0000 


OOAD 


and assign the address of the leftmost byte to the symbol HEXCON. The following table 
shows some sample DC instructions for the various constant types: 


Implicit length 
(Bytes) 


as needed 
as needed 
as needed 
as needed 
as needed 


DC Instruction 


B‘101’ 

C’ABCD’ 
P‘ABCD’ 
S‘ABCD’ 
X‘FFFF’ 


Alignment 
(If explicit length not 
specified) 








F*2: 

H‘2’ 

D‘2’ 

E‘1.414’ 

L‘1.414’ 

A (TABLE) 

V (EXTDATA) 
W (WEAKDATA) 


Sct pPrmomnrtxHnvVOHO 


The nominal values specified for constants are assembled into storage. The amount of 
space available for the nominal value of a constant is determined: 


e By the explicit length specified in the second subfield of the operand, or 

e If no explicit length is specified, by the implicit length according to the type of 
constant defined (see preceding table) 

If more space is available than is needed to hold the binary representation of the 

nominal value, the extra space is padded: 

e With binary zeros on the left for the binary (B), hexadecimal (X), fixed-point (F, H, 
and D), address (A) constants 

e With binary zeros on the right for floating-point (E and L) constants 

e With blank character codes on the right for the character (C, P, and S) constants 


Note. Binary zeros are always assembled for V- and W-type constants. 
The following examples indicate the results of padding the different type data constants: 


B‘101’ 05 

X‘F’ OF 
XL4°C4F’ 00000C4F 
F‘255’ OOFF 

H‘6’ 06 
0003151A 
44B09C00 


D‘202010’ 
E*575E2’ 
L‘73E4’ 45B23900 
AL2(512) 0200 


CL6°ABCD’ C1C2C3C44040 
SL4‘A’ 41202020 
P‘ABC’ E2E4E7 
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If less space is available than is needed to hold the nominal value, the nominal value is 
truncated and part of the constant is lost or the value is assembled as zero. Truncation of 
the nominal value is: 

e On the left for binary (B) and hexadecimal (X) constants 

e On the right for character (C, P, and S) constants 

The following types of constants are not truncated: 

e Fixed-point (F, H, and D) constants are rounded if necessary. If the value exceeds the 
allowable range, zeros are assembled into the field. 

e Floating-point (E and L) constants are rounded. 

e Address (A) constants are not truncated. If the nominal value cannot be represented in 
the space available, the constant is flagged and assembled as zero. 

The following examples indicate the results of truncating the different type data 


constants: 


























DC —_BL2‘01111000011110000’ FOFO 
DC XL4‘FFCOOFFC8’ FCOOFFC8 
DC A(65535+1) 0000 (*ERROR*) 
DC CL2‘ABCD’ C1C2 
DC SL2‘ABC 4142 
F*32770 0000 (*ERROR*) 
0001 






00 (*“ERROR*) 






DC Operand Subfield 1: Duplication Factor 
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The duplication factor, if specified, causes the nominal value or multiple nominal values 
specified in a constant to be generated the number of times indicated by the factor. It is 
applied after the nominal value or values are assembled into one constant. 

The factor can be specified by an unsigned decimal self-defining term or by an absolute 
expression enclosed in parentheses. The expression should have a positive value or be 
equal to zero. Any symbols used in the expression must have been previously defined. 

The following examples indicate the results of specifying a duplication factor in the 
constant definition: 


Constant definition Value assembled (Hex) 


DC 3F*‘240’ ONOFOOOFOOOFO 


DC 2F°3,4’ 0003000400030004 


EQU 5 
DC (A-3) F'S’ 00050005 





Notes. 


1. A duplication factor of zero is permitted with the following results: 

a. No value is assembled. 

b. If the zero duplication factor is used on an F-, D-, E-, L-, A-, W-, or V-type 
constant, the location counter is forced to a word boundary. A byte of zeros is 
placed in the object text. 

2. If duplication is specified for an address constant containing a location counter 
reference, the value of the location counter reference is not increased until after 
the DC instruction is completely processed. Therefore, 





generates 2 words, each containing the address of X. 
DC Operand Subfield 2: Type 


The type subfield must be coded. It defines the type of constant to be generated and is 
specified by a single letter code as shown below. 
The type specification indicates to the assembler: 

1. How the nominal value (or values) coded in subfield 4 is to be assembled; that is, 
which binary representation or machine format the object code of the constant must 
have. 

2. How much storage the constant is to occupy, according to the implicit length of the 
constant if no explicit length specification is present. (For details see “Padding and 
Truncating Constants.’’) 


C 
S 

P 

X 
B 

F 
H 
D 
F 
L 
A 
V 
WwW 


EBCDIC 
ASCII 
PTTC/EBCD 
Hexadecimal 
Binary 
Fixed-point 
Fixed-point 
Fixed-point 
Floating-point 
Floating-point 
Address 
Address 
Address 


8-bit code for each character 

8-bit code for each character 

8-bit code for each character 

4-bit code for each digit 

1-bit for each digit 

Signed, Fixed-point binary; normally 2 bytes (can be 1-2 bytes) 
Signed, Fixed-point binary; always 1 byte 

Signed, Fixed-point binary; normally 4 bytes (can be 1—4 bytes) 
Floating-point binary; normally 4 bytes (can be 2—4 bytes) 
Floating-point binary; normally 8 bytes (can be 2—8 bytes) 
Value of address or expression; 1—4 bytes 

Space reserved for external address; always one word 


Space reserved for external address; always one word 
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DC Operand Subfield 3: Modifiers 

The 3 modifiers you can code to describe a constant are: 

e The length modifier (L), which explicitly defines the length in bytes desired for a 
constant. 

e The scale modifier (S), which is only used with the fixed-point or floating-point 
constants (for details see “Scale Modifier”). 

e The exponent modifier (E), which is only used with fixed-point or floating-point 
constants, and indicates the power of 10 by which the constant is to be multiplied 
before conversion to its internal binary format. 


If multiple modifiers are used, they must appear in the sequence: length, scale, 
exponent. 


Length Modifier 


The length modifier indicates the explicit number of bytes into which the constant is to 
be assembled. You code it as Ln, where n is either of the following: 


e A decimal self-defining term. For example, 
SDTERM DC = XL3' FF! 


e An absolute expression enclosed in parentheses. It must have a positive value and any 
symbols it contains must have been previously defined; that is, in an instruction that 
physically precedes this DC in the source module. For example, 


DC XL(AtK) FFE 


re a a ee Se 9 
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Scale Modifier 


When you specify the length modifier: 


e Its value determines the number of bytes allocated to a constant. It therefore 
determines whether the nominal value of a constant must be padded or truncated to 
fit into the space allocated. (See “Padding and Truncating Constants.”) 

e Any boundary alignment normally implied by the constant type is lost. The constant 
assembles starting with the next available byte. 

e {ts value must not exceed the maximum length allowed. (For the allowable range of 
length modifiers, see the specifications for the individual constants and areas in this 
chapter.) 


The scale modifier specifies the amount of scaling (shifting) desired for fixed-point or 
floating-point constants. The scale modifier specifies a shifting count of: 
e Binary digits for fixed-point (F, H, and D) constants 
¢ Hexadecimal digits for floating-point (E and L) constants 
The scale modifier is written as Sn, where n is either: 


e A decimal self-defining term or 

e An absolute expression enclosed in parentheses. Any symbols used in the expression 
must have been previously defined; that is, in an instruction that physically precedes 
this DC in the source module. 


Both types of specifications can be preceded by a plus or minus sign; if no sign is 
present, a plus sign is assumed. 
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Scale Modifier for Fixed-point Constants. The scale modifier for fixed-point constants 
specifies the power of 2 by which the fixed-point constant is to be multiplied after its 
nominal value has been converted to a binary representation, but before it is assembled in 
its final scaled form. Scaling causes the binary point to move from its assumed fixed 
position at the right of the rightmost bit position. 
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Notes. 


1. When the scale modifier has a positive value, it indicates the number of binary 
positions to be occupied by the fractional portion of the binary number. 

2. When the scale modifier has a negative value, it indicates the number of binary 
positions to be deleted from the integer portion of the binary number. 

3. When positions are lost because of scaling (or lack of scaling), rounding occurs in the 
leftmost bit of the lost portion. The rounding is reflected in the rightmost position 
retained. 

4. Scaling must not cause a value overflow condition, nor is it permitted that all 
significant bits be lost. 

5. The assembler must be able to internally maintain the fixed point number prior to 
scaling. The integer portion must be represented in 32 bits. 





Object code 


Converted to binary representation Binary digits Binary 


point 







DCF S#+4 "(8.5 


Assembled constant 







Converted to binary representation ; 
Binary 


point 





DC 





Binary 
point 


DC 


Binary 
point 


DC 









Assembled constant 00000000 00001001) 11 
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ROUND 


ERROR 


oc 


DC 


DC 


OC 


DC 


Scale Modifier for Floating-point Constants. The scale modifier for floating-point 
constants must have a positive value. It specifies the number of hexadecimal positions 
that the fractional portion (mantissa) of the binary representation of a floating-point 
constant is to be shifted to the right. The hexadecimal point is assumed to be fixed at the 
left of the leftmost position in the fractional field. When scaling is specified, it causes an 
unnormalized hexadecimal fraction to be assembled. (A number is unnormalized when 
the leftmost positions of the fraction contain hexadecimal zeros). The magnitude of the 
constant is retained because the exponent in the characteristic portion of the constant is 
adjusted upward accordingly. When hexadecimal positions are lost, rounding occurs in the 
leftmost hexadecimal position of the lost portion. The rounding is reflected in the 
rightmost position retained. Scaling must not cause all significant mantissa digits to be 
lost. 
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Exponent Modifier 





The exponent modifier specifies the power of 10 by which the nominal value of a 

constant is multiplied before being converted to its internal binary representation. You 

can only use it with the fixed-point (F, H, and D) and floating-point (E and L) constants. 

You code the exponent modifier as En, where n is either: 

e A decimal self-defining term or 

e An absolute expression enclosed in parentheses. Any symbols used in the expression 
must be previously defined, that is, in an instruction that physically precedes this DC 
in the source module. 


You can precede the decimal self-defining term or the expression with a sign; if no sign 


is present, a plus sign is assumed. The range for the exponent modifier is -85 through 
+75. 


Detimal value Object code 
before conver- 





‘sion to binary (Binary digits) © es 
| ~ form - 
- EQU 5 fo Fon ee 
EQU | - SORE MEL REE ATT Oe 
pc OFA! 4 00000000 | 00000100}, 
“Fe2"h 0 I 
FE(A-B*3) "4! 400 —- [ooo00001] 10010000 
FE-2' gg! 4 00000000 | 00000100] 


Assembler Instructions 5-15 


Notes. 


1. Do not confuse the exponent modifier with the exponent you specify in the nominal 
value subfield of fixed-point and floating-point constants. 

The exponent modifier affects each nominal value in the operand, whereas the 
exponent you code as part of the nominal value subfield affects only that nominal 
value. If both types of exponent specification are present in a DC operand, their 
values are algebraically added together before the nominal value is converted to 
binary form. However, this sum must be within the permissible range of —85 through 
+75. 

2. The value of the constant, after exponents are applied, must be contained in the 
implicit or explicitly specified length of the constant. Also, significance must not be 
permitted to be completely lost. 


Values assembled 
in decimal 


DC -E'2,256+2,2.25,2256-2' | 225, 2.25, 2.25 







, 


DC 


DC 


DC =—- FE-21'2, 25€+8g" Pag gO rere 


|Too large for] | 
16-bit value <— 


Storage Requirements for Constants. The total amount of storage required to assemble a 
DC instruction operand is any bytes skipped for alignment, plus the product of: 

e The length (implicit or explicit), and 

e The duplication factor (if specified) 









The maximum amount of storage allowed for a constant is 256 bytes. 
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DC Operand Subfield 4: Nominal Value 
You must code the nominal value subfield in a DC instruction. It defines the value of the 
constant (or constants) described and affected by the subfields that precede it. It is this 
value that assembles into the internal binary representation of the constant. 

Only one nominal value is allowed for C-, S-, P-, B-, and X-type constants. How nominal 
values are specified and interpreted by the assembler is explained in the sections that 
describe each individual constant. The formats for specifying nominal values are described 
in the following table. 


Format of nominal value subfields 
Constant Single Multiple 
type 


Not allowed 


‘Value,value,. . ., value’ 


C 
P : 
S 
B 
Xx 
F 
H 
D 
E 
L 


separated by commas 


Sf | eae —— _ ™ 


a<> 
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* DC INSTRUCTION 


This character constant specifies character strings that the assembler converts into their 
internal EBCDIC representation. 

The maximum number of bytes generated by one DC statement is 256. Each character 
specified in the nominal value subfield assembles into one byte. 

Multiple nominal values are not allowed; the assembler considers the comma as a valid 
string character. Scale and exponent modifiers are not allowed. 
Note. When ampersands or apostrophes are to be included in the assembled constant, 
double ampersands or double apostrophes must be specified; they are assembled as a 
single ampersand or single apostrophe. 

The contents of the subfields defining a character constant are described by the 
following examples: 






















hgc' ! DUPLICATION. FACTOR. As. LOW, cs 

C'ABCD! IMPLICIT. LENGTH AS: NEEDED. i | 

CL256! ' "RANGE FOR LENGTH IS 1 to. 256. BYTES 

C'ABI2#$° VALUE. REPRESENTED BY CHARACTERS. | 

cite TWO APOSTROPHES ASSEMBLE AS ONE. 

C'eg' TWO AMPERSANDS ASSEMBLE AS ONE 

cr,! COMMA ASSEMBLES AS. siariains 

ch “NOMINAL VALUE ENCLOSED ay & 
APOSTROPHES = pend 

C'AB,C' MULTIPLE NOMINAL. VALUES. NOT. ‘PossiBLe. 

CL2'A! PADDED WITH EBCDIC BLANKS | 

CLI'ABC! “TRUNCATION OF VALUE AT RIGHT 





ASCII Character Constant (S) 
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LENGTH 
RANGE 


VALUE 


ENCLOS 
* 


MULT I 
PAD 


TRUNC 


This character constant specifies character strings, such as message text, that the 
assembler converts into their internal ASCII representation. ASCII code is generated as a 
7-bit character code with the high-order bit of zero. 

The maximum number of bytes generated by one DC statement is 256. Each character 
specified in the nominal value subfield assembles into one byte. 

Multiple nominal values are not allowed; the assembler considers the comma as a valid 
string character. 
Note. Specify double ampersands or double apostrophes for each single ampersand or 
single apostrophe you want assembled into the constant. See Appendix B for valid ASCII 
characters. 


DESCRIPTION 


Ags! DUPLICATION FACTOR 1S ALLOWED 

S'ABCD! IMPLICIT LENGTH AS NEEDED 

SL256' ' RANGE FOR LENGTH 1S 1 to 256 BYTES 

S'ABI2#5! VALUE REPRESENTED BY CHARACTERS 

stent TWO APOSTROPHES ASSEMBLE AS ONE 

S' 5g! TWO AMPERSANDS ASSEMBLE AS ONE 

sg) COMMA ASSEMBLES AS COMMA 

stot NOMINAL VALUE ENCLOSED BY 
APOSTROPHES 

S'AB,C! MULTIPLE NOMINAL VALUES NOT POSSIBLE 

SL2'A! PADDED WITH ASCII BLANKS AT RIGHT 

SLI'ABC! TRUNCATION OF VALUE AT RIGHT 


Assembler Instructions 5-19 


PTTC/EBCD Character Constant (P) 


DUP DC 
LENGTH OC 
RANGE DC 
* 


This character constant specifies character strings that the assembler converts into their 


internal PTTC/EBCD representation. See Appendix C for valid PTTC/EBCD characters. 


The maximum number of bytes generated by one DC statement is 256. Each character 
you code in the nominal value subfield assembles into one byte. 

Multiple nominal values are not allowed; the assembler considers the comma as a valid 
string character. 
Note. Specify double apostrophes or ampersands for each single apostrophe or ampersand 
you want assembled into the constant. 


gp | DUPLICATION FACTOR IS ALLOWED, 


P' ABCD! IMPLICIT LENGTH AS NEEDED. r 
 PL256' # RANGE FOR LENGTH 1S 1 THROUGH 256, 
ea BYTES.’ pr 38 


* SCALE MODIFIER AND EXPONENT MODIFIER ARE NOT ALLOWED. 


VALUE DC 
DC 
DC 
DC 
ENCLOS OC 
* 


P'ABI2#S' VALUE REPRESENTED BY CHARACTERS. 

per 2 APOSTROPHES ASSEMBLE AS ONE, 

P'és! 2 AMPERSANDS ASSEMBLE AS ONE. 

Pr COMMA ASSEMBLES AS COMMA. 

py NOMINAL VALUE ENCLOSED BY 
APOSTROPHES. 


* EXPONENT NOT ALLOWED IN NOMINAL VALUE SUBFIELD. 


MULT | DC 
* 
PAD DC 
* 
TRUNC DC 
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P'AB,C! MULTIPLE NOMINAL VALUES NOT 
POSSIBLE. 

pial PADDED WITH PTTC/EBCD BLANKS AT 
RIGHT. 

PLI'ABC! TRUNCATION OF VALUE OF RIGHT. 


Hexadecimal Constant (X) 


VALUE 
ioe 


PAD 


TRUNC 


Binary Constant (B) 


LENGTH 
RANGE 
VALUE I 


ENCLOS 









You can use hexadecimal constants to generate large bit patterns more conveniently than 
with binary constants. Also, the hexadecimal values you specify in a source module allow 
you to compare them directly with the hexadecimal values generated for the object code 
and address locations printed in the program listing. 

Each hexadecimal digit specified in the nominal value subfield is assembled into 4 bits. 
The implicit length in bytes of a hexadecimal constant is then one-half the number of 
hexadecimal digits specified (assuming that the number of digits is a multiple of 2). 

The contents of the subfields defining a hexadecimal constant are described by the 


following examples: 


C INSTRUCTION, 


-2xig - 
XO FFFFE 
XL256'p' 


X'S9AF! 
X'FFFF! 


X'FE 


XLV FFFFF! 


VALUE REPRESENTED. BY 


oe PT ION 


DUPLICATION FACTOR Is | ALLOWED. 


IMPLICIT LENGTH AS. NEEDED Se oceee eee ee 


HEXADECIMAL DIGITS 





“NOMINAL VALUE. meme 
‘APOSTROPHES 





PADDED WITH BINARY. ZEROS: at Lert 


TRUNCATION OF VALUE AT LEFT ; 


The binary constant specifies the precise bit pattern you want to assemble into storage. 
Each binary constant assembles into the integral number of bytes required to contain the 


bits specified. 


The contents of the subfields defining a binary constant are described by the following 


examples: 


* ‘oc INSTRUCT 10N 


2B gi! 
ope 
BL256'g' 
 Bigipig" 
oy 


_ DUPLICATION | FACTOR RIS AL 
IMPLICIT. LENGTH “AS NEEDI 


RANGE. FOR LENGTH As 1 te 


| APOSTROPHES 
 BNIgg 1" PADDED WITH BINARY ZEROS 


BLINTIT IS 999111 19gggi' = TRUNCATI. ON oF VALUE A T LEFT 


DESCRIPTION. 




















VALUE. REPRESENTED. BY BINA as 


NOMINAL VALUE poate 
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Fixed-point Constant (F) 


* DC INSTRUCTION DESCRIPTION 


A fixed-point constant is written as a decimal number and can be followed by a decimal 
exponent. The number can be an integer, a fraction, or a mixed number (one with 
integral and fractional portions). The format of the constant is as follows: 


e The number is written as a signed or unsigned decimal value. The decimal point can be 
placed before, within, or after the number. If it is omitted, the number is assumed to 
be an integer. A positive sign is assumed if an unsigned number is specified. 

e The exponent is optional. If specified, it is written immediately after the number as 
En, where n is an optionally signed decimal value specifying the exponent of the factor 
10. The exponent must be in the range —85 to +75. If an unsigned exponent is 
specified, a plus sign is assumed. 


The number is converted to binary, the exponent and scale factor (if any) are applied, 
the number is rounded and assembled into the proper field, according to the specified or 
implied length. An implied length of 2 bytes is assumed if a length is not specified. The 
resulting number does not differ from the exact value by more than one in the last binary 
position. If the value of the number exceeds the allowable range (—32768 to 32767), the 
statement is flagged and a zero is assembled into the whole field. Any duplication factor 
that is present is applied after the constant is assembled. A-negative number is carried in 
twos complement form. 


; Ane 
DUP pc AFT! _ DUPLICATION FACTOR IS ALLOWED rene 
LENGTH DC Figg! IMPLICIT LENGTH IS ALWAYS 2 BYTES 
RANGE DC FLI'I¢¢" LENGTH MODIFIER MUST BE 1 0R2, 
ae VF USED | SSArEh eats 
VALUE OC  — F'32767' VALUE cadre cn 
ENCLOSE DC F'-I! NOMINAL VALUE ENCLOSED BY 

| “APOSTROPHES arees 
EXPVAL DC F'1,414E2! EXPONENT ALLOWED IN NOMINAL “VALUE; 
RANGE FOR EXPONENT 1S -85 TO +75 
PAD =—soc:—séFVQ PADDED WITH BINARY ZEROS AT LEFT 
MULTI = DCS S*F1,,2,3! MULTIPLE NOMINAL VALUES ALLOWED 
SCALE DC  FS6'=25.46' RANGE FOR SCALE 1S -187 TO +346 
EXPON = DC FE2 "46415! RANGE FOR EXPONENT IS -85 TO +75 
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Note. Truncation of F-type constants is not allowed. 


Fixed-Point Constant (H) 


An H-type (halfword) fixed-point constant is identical to an F-type constant, except that 
the H-type constant is assembled as a 1-byte field on a byte boundary. The maximum 
range of an H-type constant is —128 to 127. 


* OC INSTRUCTION DESCRIPTION, 7 
DUP CN DUPLICATION FACTOR IS ALLOWED 
LENGTH DC H'Ig? IMPLICIT LENGTH 1S ALWAYS 1 BYTE | 
RANGE DC HLI' Ig LENGTH MODIFIER MUST BE 1, IF USED | 
VALUE DC _-H!35! VALUE REPRESENTED BY DECIMAL DIGITS — 
ENCLOS DC H'=1! NOMINAL VALUE ENCLOSED BY 

"ae APOSTROPHES 

EXPVAL DC  H'21E=1' EXPONENT ALLOWED IN NOMINAL VALUES; 

Es oboe RANGE FOR EXPONENT IS 85 to +75. 
PAD OCCHI2*§ PADDED WITH BINARY ZEROS AT LEFT 


Note. Truncation of H-type constants is not allowed. 


Fixed-Point Constant (D) 


A D-type (doubleword) fixed-point constant is identical to an F-type constant, except 
that the D-type constant is assembled as a 4-byte field on a word boundary. The 
maximum range of a D-type constant is-2°* to 2°'-1. 


* DC INSTRUCTION DESCRIPTION 


OUP) CDI DUPLICATION FACTOR IS ALLOWED 

LENGTH DC  D'1¢ggg" IMPLICIT LENGTH IS ALWAYS 4 BYTES 
RANGE DC  ODLA'I@¢@g@g' ==———LENGTH MODIFIER MUST BE 1, 2, 30r 
e 4, IF USED 

VALUE DC —D'66! VALUE REPRESENTED BY DECIMAL DIGITS 
ENCLOS DC D!=I' NOMINAL VALUE ENCLOSED BY 

* APOSTROPHES | 
EXPVAL DC D'231.62E-2' EXPONENT ALLOWED IN NOMINAL VALUE; _ 
t RANGE FOR EXPONENT IS -85 to +75 


PAD oc so gf PADDED WITH BINARY ZEROS AT LEFT — 


Note. Truncation of D-type constants is not allowed. 
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Floating-Point Constant (E) 


An E-type (single-precision) floating-point constant is written as a decimal number and 
can be followed by a decimal exponent. The number can be an integer, a fraction, or a 
mixed number (one with integral and fractional portions). The format of the constant is 
as follows: 


e The number is written as a signed or unsigned decimal value. The decimal point can be 
placed before, within, or after the number. If it is omitted, the number is assumed to 
be an integer. A positive sign is assumed if an unsigned number is specified. 

e The exponent is optional. If specified, it is written immediately after the number as 
En, where n is an optionally signed decimal value specifying the exponent of the factor 
10. The exponent must be in the range —85 to +75. If an unsigned exponent is 
specified, a plug sign is assumed. 

The external format for a floating-point number has 2 parts: the portion containing the 
exponent, which is sometimes called the characteristic, followed by the portion 
containing the fraction, which is sometimes called the mantissa. Therefore, the number 
specified as a floating-point constant must be converted to a fraction before it can be 
translated into the proper format. 

For example, the constant 27.35E2 represents the number 27.35 times 107. 
Represented as a fraction, 27.35E2 would be 0.2735 times 10*, the exponent having 
been modified to reflect the shifting of the decimal point. Thus, the exponent is also 
altered before being translated into machine format. 

In machine format, a floating-point number also has 2 parts, the signed exponent and 
signed fraction. The quantity expressed by this number is the product of the fraction and 
the number 16 raised to the power of the exponent. 

The exponent is translated into its binary equivalent in excess 64 binary notation and 
the fraction is converted to a binary number. Leading hexadecimal zeros are removed. 
Rounding of the fraction is then performed according to the specified or implied length, 
and the number is stored in the proper field. The resulting number does not differ from 
the exact value by more than one in the last place. 

The maximum range of the magnitude of an E-type constant is approximately 107° to 
107°. If this range is exceeded, the DC instruction is flagged and a zero is assembled into 
the whole field. 

Within the portion of the floating-point field allocated to the fraction, the hexadecimal 
point is assumed to be to the left of the leftmost hexadecimal digit, and the fraction 
occupies the leftmost portion of the field. Negative fractions are carried in true 
representation, not in the twos complement form. 

As an example, the machine representation of the floating-point constant E‘55.125’ 
would be: 


Bit Portion of constant Contents 


Sign bit of mantissa 0 


Exponent X°42’ 
Mantissa X‘°372000° 
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* DC INSTRUCTION 
* 


DUP 
LENGTH 


RANGE 
* 


VALUE 
ENCLOS 
* 


EXPVAL 
* 


PAD 
TRUNC 
SCALE 


EXPON 


Floating-Point Constant (L) 


hE" .99925' 
E'1,315' 


ELA'T. 111! 
E') 41416! 
E']° 
E'1E~89' 


E'Sg! 
E ‘ ~123.456789' 


ES6' 199" 
EE-85'1' 


DESCRIPTION 
DUPLICATION FACTOR 1S ALLOWED 
IMPLICIT LENGTH 1S ALWAYS 4 BYTES 


LENGTH MODIFIER MUST BE 2 3, OR 4, 
IF USED | 


VALUE REPRESENTED BY Leone sc 


NOMINAL VALUE ENCLOSED BY... 
APOSTROPHES 


EXPONENT ALLOWED IN NOMINAL «ines 
RANGE FOR EXPONENT 1S -85 TO +75 


PADDED WITH BINARY ZEROS AT RIGHT 
VALUE 1S ROUNDED a 
RANGE FOR SCALE IS @ THROUGH 6 


RANGE FOR EXPONENT IS ~85 TO +75 


An L-type (double-precision) floating point constant is identical to an E-type constant 
except that the L-type constant is assembled as an 8-byte field on a word boundary. The 
resulting constant consists of a 1-byte sign and exponent plus a 7-byte hexadecimal 


fraction. 


* DC INSTRUCTION 


* 


pup 
LENGTH — 


RANGE 
fe. 


VALUE 


ENCLOS 
* 


EXPVAL 
* 


PAD 


4L'.gg25' 


LL8'1, 315! 


L'1.41416' 


Lt! 
L'1E~8g! 


L'sg! 


DUPLICATION: FACTOR ts “ALLOWED 


DESCRIPTION | 





IMPLICIT LENGTH 1s “ALWAYS. 8 BYTES. 


LENGTH MODIFIER MUST BE 2, ay. A, an 
6, 7, 08.8, 1F USED oT 


VALUE REPRESENTED BY DECIMAL L oreins 


NOMI NAL VALUE ENCLOSED BY 
APOSTROPHES 


RANGE FOR EXPONENT IS ~85 TO +75 


EXPONENT ALLOWED IN NOMINAL wines 


PADDED WITH BINARY zeros ar alGit” 
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A-Type Address Constant 
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This section and the two following sections describe how the different types of address 
constants assemble from expressions that usually represent storage addresses, and how 
you use the constants for addressing within and between source modules. 

In the A-type address constant, you can specify any of the three types of assembly-time 
expressions (see “Expressions” in Chapter 2), whose value the assembler then computes 
and assembles into object code. You use this expression computation as follows: 


e Relocatable expressions for addressing 
e Absolute expressions for addressing and value computation 
e Complex relocatable expressions to relate addresses in different source modules. 

The value of the location counter reference (*) when specified in an address constant 
does not vary from constant to constant if a duplication factor, multiple nominal values, 
or multiple operands are specified. 

The contents of the subfields defining the A-type address constants are described by the 
following examples. 


: DC INSTRUCTION DESCRIPTION 

DUP oc HA) DUPLICATION FACTOR ALLOWED 

LENGTH DC A(LABEL) IMPLICIT LENGTH IS ALWAYS 2 BYTES 

RANGE DC ALI (LABEL) LENGTH MODIFIER CAN BE FROM 1 TO 4; 

* ONLY LENGTH 2 IS VALID FOR A 

* RELOCATABLE VALUE=-LENGTHS 1, 3, AND 

* 4 MUST BE FOR ABSOLUTE VALUES 

VALUE DC A(LABEL+2) VALUE REPRESENTED BY ANY EXPRESSION 

ENCLOS DC A(*=#) NOMINAL VALUE ENCLOSED BY 

* PARENTHESES 

MULTI oc A(LABEL,SYMBOL) MULTIPLE NOMINAL VALUES ALLOWED 

PAD DC A(1) PADDED WITH BINARY ZEROS AT LEFT 
Note. Truncation of A-type constants is not allowed; if the value is too large, a zero is 
assembled and the statement is flagged as an error. 


V-Type Address Constant 


The V-type address constant reserves storage for the address of a location in another 
source module. You can use the V-type address constant to branch to the external 
address. (There are other ways to branch to external addresses, as described in “Symbolic 
Addressing Between Source Modules—Symbolic Linkage” later in this chapter.) 

When you specify a symbol in a V-type address constant, the assembler assumes that it 
is an external symbol. A value of zero is assembled into the space reserved for the V-type 
constant; the correct relocated value of the address is inserted into this space by the 
linkage editor. The symbol specified in the nominal value subfield does not constitute a 
definition of the symbol for the source module in which the V-type address constant 
appears. 

The contents of the subfields defining the V-type address constants are described in the 
following examples. 


‘ DC INSTRUCTION DESCRIPTION 

DUP DC  4V(EXTERNAL) DUPLICATION FACTOR 1S ALLOWED 
LENGTH DC  V(EXTERNAL) IMPLICIT LENGTH IS ALWAYS 2 BYTES 
RANGE DC _—VL2 (EXTERNAL) LENGTH MODIFIER MUST BE 2, IF USED 
VALUE DC _—~V (EXTERNAL) VALUE REPRESENTED BY SINGLE 

* RELOCTABLE SYMBOL 

ENCLOS DC  V(EXTERNAL) NOMINAL VALUE ENCLOSED BY 

* PARENTHESES 

MULTI DC «(EXT 1, EXT2) MULTIPLE NOMINAL VALUES ALLOWED 


Note. Truncation of V-type constants is not applicable. 
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W-Type Address Constant 


Specified as one relocatable symbol, the W-type address constant reserves storage for the 
address of a weak external symbol that refers to other source modules. For unresolved 
symbols defined in a W-type constant, the linkage editor issues warning messages rather 
than error messages. The implied length of a W-type address constant is 2 bytes. 
Specifying a symbol as the operand of the constant does not constitute a definition of the 
symbol. 


* DC INSTRUCTION DESCRIPTION 

DUP DC § 4W(WEAK) DUPLICATION FACTOR IS ALLOWED 

LENGTH DC W(WEAK) IMPLICIT LENGTH 1S ALWAYS 2 BYTES 
RANGE DC —_- WL2 (WEAK) LENGTH MODIFIER MUST BE 2, IF USED | 
VALUE DC W(WEAK) VALUE REPRESENTED BY SINGLE sss 
RELOCATABLE SYMBOL 

ENCLOS DC W(WEAK) NOMINAL VALUE ENCLOSED BY i (awstisi—~*tS 
r | PARENTHESES “a a ttiti‘—st 
MULTI = DCs W(WXT 1, WXT2) MULTIPLE NOMINAL VALUES ALLOWED 


The DS instruction 
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Note. Truncation of W-type constants is not applicable. 


The DS instruction allows you to: 
e Reserve areas of storage 
e Provide labels for these areas 
e Use these areas by referring to the symbols defined as labels 
The format of the DS instruction is like that of the DC instruction: 


feos | ae | eto fl om 


where operand consists of the same 4 subfields as the DC statement. However, with the 
DS instruction no data is assembled and the nominal value subfield is therefore optional. 
The subfields for the DS instruction operand are: 


duplication factor (optional) 

data type (required) 

modifiers (optional) 

nominal value or values (optional) 










The maximum length that can be specified in a DS operand is 65,535 bytes rather than 
the DC instruction limit of 256 bytes. 

The label of a DS instruction, like the label of a DC instruction, has an address value of 
the leftmost byte of the area reserved. | 

If the DS instruction is specified with more than one nominal value, the label addresses 
the area reserved for the field that corresponds to the first nominal value. 


Using the DS instruction to reserve storage. The DS instruction is the best way to 
symbolically define storage for work areas and I/O buffers. If you wish to take advantage 
of implicit length calculation, do not supply a length modifier in your operand 
specification. Specify a type subfield that corresponds to the type of area you need. 





* DS INSTRUCTION = =——_ STORAGE. RESERVED. 
FAREA DS F = 2 2 BYTES 

XAREA DS X | 2 BYTES | 
DUPFAC OS 8F 16 BYTES 

EAREA 0S  3E hapa iiss) B2 BYTES 


To reserve large areas, you can use a duplication factor. You can also use character (C 
and S) or hexadecimal (X) field types to specify large areas using the length modifier. 


mad i 
* wae : sapauee 







nice 

Gee 

frente 

Pada 
+ anon ini on aaa 

ota = 

pia 

g 
j 


3 
Pines Sete 


x 
dps 
: 

: ae 
dcearear vanced 
i 

et een ee 


po 
i ee Seta wad, 


# § & ¥ 


Although the nominal value is optional for a DS instruction, you can put it to good use 
by letting the assembler compute the length of areas for the B-, C-, S-, and X- type areas. 
You achieve this by specifying the general format of the data that will be placed in the 
area at execution time. 

You can force the location counter to a word boundary by using the appropriate data 
type with a duplication factor of zero. This method ensures a boundary alignment that 
you would otherwise not have. 
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PROGRAM SECTIONING 


Using the DS instruction to name fields of an area. Using a duplication factor of zero in a 
DS instruction allows you to provide a label for an area of storage without actually 
reserving the area. You can use DS or DC instructions to reserve storage for and assign 
labels to fields within the area. These fields can then be addressed symbolically. (You can 
also do this with DSECTs as described later in this chapter.) 

Nothing is assembled into the storage area reserved by a DS instruction. No assumption 
should be made as to the initial contents of the reserved area at execution time. 

The size of a storage area that can be reserved by a DS instruction is limited by the 
maximum value of the location counter (65,535). 


This section explains how you can subdivide a large program into smaller parts so that 

they are easier to understand and maintain. It also shows how you can divide these 

smaller parts into convenient sections; for example, one section to contain your 

executable instructions and ancther section to contain your data constants and areas. 
You should consider two distinct subdivisions when writing an assembler language 

program: 

e Dividing the program into source modules 

e Dividing the program into control sections 


You can divide a program into two or more source modules. Each source module is 
assembled into a separate object module. You then use the linkage editor to combine the 
object modules into a load module, forming an executable program. 

You can also divide a source module into two or more control sections. Each control 
section of a full assembly is assembled as part of the object module. The linkage editor 
processes these control sections, producing a load module with contiguous storage 
addresses. 


Communication Between Program Parts 


The Source Module 


The Beginning of a Source Module 
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You must be able to communicate between the parts of your program; that is, be able to 
refer to data in a different part or be able to branch to another part: 


e To communicate between 2 or more source modules, you must symbolically link them 
together; symbolic linkage is described in “Symbolic Addressing Between Source 
Modules—Symbolic Linkage’’ in this chapter. 

e To communicate between control sections within a source module, you must establish 
the addressability of each control section; establishing addressability is described in 
“Symbolic Addressing Within Source Modules—Establishing Addressability” in this 
chapter. 


A source module is composed of source statements in the assembler language. Write them 
on a coding form and then use the text editor to enter them as input onto a diskette. 


The first statement of a source module can be any assembler language statement. 
described in this manual (except MEND, MEXIT, or END). You should initiate the first 
control section of a source module with the START or CSECT instruction. However, you 
can, Or in some cases must, write source statements before the beginning of the first 
control section. (For a list of these statements see “First Control Section” in this 
chapter.) 


The End of a Source Module 


The END instruction marks the end of a source module. Only one END instruction is 
allowed. The assembler does not process any instruction that follows the END 
instruction. 


END-—End Assembly 


The END instruction marks the end of a source module. It indicates to the assembler 
where to stop assembly processing. 

You can also supply on the END instruction the address of the location in your 
program where execution must start. This location is quite often the address of the first 
executable instruction in the source module. In this case leave the operand blank. Later, 
if you wish, you can override this location in your response to the ENTRY= linkage 
editor prompt. 


Note. The entry address you specify in response to the linkage editor ENTRY= prompt 
must be a CSECT name or a name defined in an assembler ENTRY instruction. The entry 
address in an END instruction can be any name defined in your source module. 


The format of the END instruction statement is: 





relocatable expression OR blank 


If specified, the relocatable expression must meet one of the following conditions: 
e It must be a relocatable expression representing an address in the source module 
delimited by the END instruction, or 
e If it contains an external symbol, that symbol must be the only term in the expression, 
or the remaining terms in the expression must reduce to zero. 
The following example indicates the use of the END instruction: 


PROG START 
ENTER EQU * 
os END ENTER 


General Information About Control Sections 


A control section is the smallest subdivision of a program that can be relocated as a unit. 
The assembled control sections contain the object code for machine instructions and 
data. 


Control Sections at Different Processing Times 
| Consider the concept of a control section at different processing times: 


At coding time. You create a control section when you write the instructions it contains. 
In addition, you establish the addressability of each control section within the source 
module, and provide any symbolic linkages between control sections that are in different 
source modules. 
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At assembly time. The assembler translates the source statements in the control section 
into object code. Each source module is assembled into one object module. The entire 
object module and each of the control sections it contains is relocatable. 


At link-edit time. Based on your responses to linkage editor INCLUDE= prompts, the 
linkage editor combines the object code of one or more control sections into one load 
module. It also calculates the linkage addresses necessary for communication between 
two or more control sections from different object modules. By responding to the 
ENTRY= prompt, you can specify the entry point address in your program where 
execution is to start. 


Types of Control Sections 


An executable control section begins with the START or CSECT instructions and is 
assembled into object code. At execution time, an executable control section contains the 
binary data assembled from your coded instructions and constants. 


Note. An executable control section is usually named. You can also initiate an executable 
control section as “private code’ when you omit the START or CSECT instruction, or 
when you specify an unnamed START or CSECT instruction. (See “Unnamed Control 
Section” in this chapter.) 


A reference control section begins with the DSECT instruction and is not assembled 
into object code. You can use reference control sections to describe the contents of data 
areas to your executable control sections (CSECT). 


Location Counter Setting 


The assembler maintains a separate internal location counter for each control section so 
that they can be intermixed in your source module. The location counter for each control 
section is set to zero at the beginning of that control section. The location values assigned 
to the instructions and other data in a control section are relative to the beginning of that 
control section. 

You can continue a control section that has been discontinued by another control 
section and thereby intersperse code sequences from different control sections. Note that 
the location values that appear in the listings for a control section, divided into segments, 
follow from the end of one segment to the beginning of the subsequent segment. 








oe a 








i SSEET 


i 
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First Control Section 


The following specifications apply only to the first executable control section, and not to 
a reference control section: 


Instruction that establish the first control section. Any instruction that affects the 
location counter or uses its current value establishes the beginning of the first executable 
control section. The instructions that establish the first control section are: 


All machine instructions 
CSECT 
DC 
DROP 
DS 
END 
EQU 
EQUR 
ORG 
START 
USING 


These instructions are always considered a part of the control section in which they 
appear. The DSECT instruction initiates reference control sections and does not establish 
the first executable control section. 


What must come before the first control section. Source macro definitions, if specified, 
must appear before the first control section. (See Chapter 5.) 


What can optionally come before the first control section. The instructions or groups of 
instructions that can optionally be specified before the first control section are: 


Macro definitions (must precede first control section) 
EJECT instruction 

ENTRY instruction 

EXTRN instruction 

PRINT instruction 

SPACE instruction 

TITLE instruction 

WXTRN instruction 

Comments statements 

Dummy control sections 

Macro call (depends on expanded body of macro) 


Notes. 


1. These instructions belong to a source module, but are not considered as part of an 
executable control section. 

2. TITLE, PRINT, SPACE, EJECT, and comment statements can precede or appear 
between source macro definitions. All other instructions in your source module must 
follow any source macro definitions. 

3. These instructions can all be coded within a control section. 


Any instructions generated with a macro call before the first control section must 
belong to one of the preceding groups of instructions. 
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Unnamed Control Section 
Each source module can have only one unnamed control section. An unnamed control 
section is an executable control section you initiate in one of the following two ways: 
e By coding a START or CSECT instruction without a name entry 
e By coding any instruction (other than the START or CSECT instruction) that initiates 
the first executable control section 
The unnamed control section is also referred to as private code. You should name all 
control sections so that you can refer to them symbolically: 
e Within a source module 
e In EXTRN and WXTRN instructions, for linkage between source modules 


External Symbol Dictionary Entries 
The assembler keeps a record of each control section and prints the following information 
about them in the external symbol dictionary: 
e Symbolic name, if one is specified 
e Type code 
ESD identification number 
Starting address 
Length in bytes 
The following table lists: 


e The assembler instructions that define control sections and dummy control sections, 
or identify entry and external symbols, and 

e The type code that the assembler assigns to the control sections or dummy control 
sections, and to the entry and external symbols. 


Instruction Instruction Type code entered into external 
label symbol dictionary 


Optional START SD if label is present 
PC if label is omitted 


Optional CSECT SD if label is present 
PC if label is omitted 


Optional Any instruction that PC 
initiates the unnamed 
control section 


Mandatory DSECT 


Blank ENTRY 
Blank ENTRN 
Blank WXTRN 


Optional DC 
(V type address 
constant) 
Optional DC 
(W type address 
constant) 


Optional BX and BALX 





Note. The maximum number of external symbol dictionary entries (control sections, 
dummy control sections, and external symbols) allowed is 254. 
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Defining a Control Section 


START—Start Assembly 


You must use the START, CSECT, and DSECT instructions to indicate to the assembler: 


e Where a control section begins, and 
e What type of control section is being defined 


The START instruction can initiate only the first executable control section in your 
source module. You should use the START instruction for this purpose, because it allows 
you to: 


e Determine exactly where the first control section begins, thereby avoiding the 
accidental initiation of the first control section by some other instruction. 
e Give a symbolic name to the first control section, so you can distinguish it from the 
other control sections listed in the external symbol dictionary. 
e Specify the initial setting of the location counter for the first or only control section. 
The START instruction, when used, must be the first instruction of the first executable 
control section in your source module. You must not precede it with any instruction that 
affects the location counter and thereby causes the first control section to be initiated. 
The format of the START instruction statement is: 


self-defining term OR blank 








START 






The symbol in the label of the START instruction identifies the first control section. 
You use the same symbol in the label of any CSECT instruction that resumes the first 
control section. This symbol represents the address of the first word in the control 
section. The assembler uses the value of the self-defining term you specify on the START 
instruction, to set the location counter initial value. The value of the operand must be 
aligned to a doubleword (divisible by 4). If you omit the operand entry, the assembler sets 
the location counter to zero. For example: 


: SOURCE STATEMENTS LISTED LOCATION (HEXADECIMAL) 
FIRST | START 256 Sigg 
: Z\lD 
SECOND  CSECT IDB 
: 9309 
FIRST  CSECT 
: Pile 
: 9228 
END 
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The source statements that follow the START instruction are assembled into the first 
control section. If a CSECT instruction indicates a continuation of the first control 
section, the source statements that follow this CSECT instruction are also assembled into 
the first control section. 

Any instruction that defines a new or continued control section marks the end of the 
preceding control section or part,of a control section. The END instruction marks the end 
of the last control section. For example: 





CSECT-—Start or Resume a Control Section 


With the CSECT instruction, you initiate an executable control section or indicate the 
continuation of an executable control section. 

You can use the CSECT instruction anywhere in a source module after your source 
macro definitions, if you have them. If you use CSECT to initiate the first executable 
control section, you must not precede it with any instruction that affects the location 
counter and thereby causes the first control section to be initiated. 

The format of the CSECT instruction statement is: 


The symbol you specify in the label of the CSECT instruction identifies the control 
section. If you have several CSECT instructions within your source module with the same 
symbol in the name field, the first occurrence initiates the control section and the rest 
indicate the continuation of the same control section. If you initiate the first control 
section with a START instruction, use the symbol in its label to indicate a continuation 
of the first control section. 

Note. Coding a CSECT instruction with a blank label either initiates or indicates the 
continuation of the unnamed control section. There can be only one unnamed control 
section in a source module. 

The symbol in the label of the CSECT instruction represents the first word in the 
control section. The source statements following a CSECT instruction assemble into the 
object code of the control section identified by that CSECT instruction. The end of a 
control section, or part of a control section, is marked by: 

e Any instruction that defines a new or continued control section, or 
e The END instruction 
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DSECT-—Start or Resume Dummy Section 


The DSECT instruction begins a dummy control section or indicates its continuation. A 
dummy control section is a reference control section that allows you to write a sequence 
of assembler language statements to describe the layout of data located elsewhere in your 
program. The assembler produces no object code for statements in a dummy control 
section and it reserves no main storage. Rather, the dummy section provides a symbolic 
format for a data area in storage. The assembler assigns location values to the symbols 
you define in a dummy section, relative to the beginning of that dummy section. 
Therefore, to use a dummy section you must: 


e Reserve a storage area for the data in an executable control section of the same or 
another source module. 

e Ensure that the data is in the area at execution time. 

e Ensure that the locations of the symbols in the dummy section actually correspond to 
the locations of data in the area. 

e Establish the addressability for the DSECT in combination with the storage area. 


You can then refer to the data symbolically by using the symbols defined in the DSECT. 

The symbol you specify in the label of the DSECT instruction identifies the dummy 
section. If you have several DSECT instructions within your source module with the same 
symbol in the name field, the first occurrence initiates the dummy section and the rest 
indicate the continuation of that dummy section. 

The symbol in the label of the DSECT instruction represents the first location described 
in the dummy section. The location counter for a dummy section has an initial value of 
zero. However, the continuation of a dummy section begins at the next available location 
in that dummy section. 

The format of the DSECT instruction statement is: 
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The label of the DSECT instruction can be any ordinary symbol. The source statements 
that follow a DSECT instruction belong to the dummy section identified by that DSECT 
instruction. Assembler language statements that appear in a dummy control section do 
not assemble into object code. 

When you establish addressability for a dummy section, the symbol in the label of the 
DSECT instruction, or any symbol defined in the dummy section can be specified in a 
USING instruction. 

A symbol defined in a dummy section can be specified in an address constant only if 
the symbol is paired with another symbol from the same dummy section, and if the 
symbols have the opposite sign. For example: 


* INSTRUCTIONS DESCRIPTION 
7 | | | 
MYPROG START 
—EXTRN DATA a 
‘MVA — DATA,R7 ESTABLISH ADDRESSABILITY eae 
| USING DUMMY , R7 NAME FIELD OF A DSECT STATEMENT = 
ADCON oc A( FROM=TO) PAIRED SYMBOLS DEFINED IN DSECT —__ 
DUMMY SECT 
TO «=§©6—rdDS-—s cL FIELDS NOT ASSEMBLED INTO. 
FROM =s«iOTS-—ess«CCLLGP OBJECT CODE | 
END 


SYMBOLIC ADDRESSING WITHIN SOURCE MODULES—ESTABLISHING 
ADDRESSABILITY 
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The assembler must be able to establish addressability for all machine instructions that 
reference a storage location. You can consider these instructions to belong to one of four 
groups: 

e Instructions that reference a location using a register as a base, such as BALX, MVWS, 
and BXS. 

e Instructions that reference a location by its effective address or by using a register as a 
base; this group includes all instructions with addr4, addr5, and longaddr formats, such 
as MVW, B, CW, and BAL. These instructions can reference any location within the 
range of the assembler’s location counter (65535). You do not have to establish 
addressability for these instructions, even if the referenced location is not in the same 
control section as the instruction. 


Note. When you use the addr form of these instruction formats, the assembler 
generates RLD items which must be processed by the linkage editor. The base 
register-displacement format is self-relocating and does not need to be relocated by the 
linkage editor. 


e Jump instructions that can only reference a location using the IAR as a base, such as J, 
JAL, and JCT. For this group, the referenced location must be relocatable and within 
the range —256 to 254 bytes of the byte following the jump instruction, and also 
within the same control section. You manually establish addressability for these 
instructions by ensuring that the referenced location is within IAR range. If the 
location is not within range, the assembler will flag the jump instruction. 

e Instructions that refer to a location specified as the contents of a register. You do not 
have to establish addressability for these instructions. 


You can establish addressability for the first two types of instructions in either of two 
ways: 

e You can code an explicit address by coding the register-displacement form of the 
operand. This method requires that you develop absolute displacements from a 
location whose address you load into the register at execution time. Using EQU 
instructions permits you to develop symbolic displacements. 

e You can let the assembler compute a displacement and index register combination that 
is suitable for referencing the required location. 

Letting the assembler compute displacements has certain advantages over other 
methods of establishing addressability: 

e All data constants and I/O buffers can be grouped together and separated from 
machine instruction logic at the end of your control section or they can be assembled 
as a separate control section. 

e Fields can be symbolically referenced, thus improving code readability. 

For the assembler to compute displacements from a register, you must, at coding time: 
e Specify a base address from which the assembler can compute the displacements 
e Assign a register to contain this base address 
e Write the instruction that loads the register with the base address 

At assembly time, the address operands you code are converted into their 
register-displacement form. Then they are assembled into the object code of the machine 
instructions in which you coded them. 

At execution time, the base address must be loaded into the register and should remain 
there throughout execution of the code that depends on that address to locate the subject 
data locations. 

The following example indicates the use of a base register to establish addressability. 


* INSTRUCTIONS DESCRIPTION 

* 

MYPROG START 
MVA  DATA,R2 LOAD BASE ADDRESS INTO REGISTER 
USING DATA,R2 SPECIFY BASE ADDRESS AND 

* ASSIGN REGISTER 


DATA 

FIELDI 
FIELD2 
FIELD3 


MVW =F IELDI,R3 


AW —- FIELD2,R3 
MVW«R3, FIELD3 
DSECT 
pss! 

DS —séF'2! 
DSStéF 

END 
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USING— Use Base Address Register 
The USING instruction allows you to specify a base address and assign a register. If you 
also load the register with the base address, you have established addressability for data 
located within, as a maximum, —32767 to +65535 bytes of the base address. To use the 
USING instruction correctly, you should: 
e Know which locations in a control section are made addressable by the USING 

instruction. 

e Know which instructions can use these addresses as operands. 
e Know which instructions can use the specified register as a base register. 

The range of a USING instruction (called the USING range) is a maximum of —32767 
to +65535 bytes from the base address specified in the USING instruction. The range 
does not extend beyond the boundaries of the executable or reference control section in 
which the base address is defined. The assembler can convert only addresses that are 
within a USING range to their register-displacement form; those outside the USING range 
cannot be converted. 

The USING range does not depend upon the position of the USING instruction in the 
source module; rather, it depends upon the location of the base address specified in the 
USING instruction. 

Note. The USING range is the range of addresses within a control section that is 
associated with the register specified in the USING instruction. 

The range of the USING instruction and the valid base registers vary according to 
individual instruction formats, as follows: 


e All instructions with addr4 operand formats: 


: Resulting register 
Coded format displacement format USING range 


addr (reg’~3,, waddr) —32767 to +65535 
(reg'~3, disp)* 0 to 255 












e All instructions with addr5 operand formats: 


Resulting register 
Coded format displacement format USING range 


addr (reg'~” , waddr) —32767 to +65535 
(teg'~” , disp)* 0 to 255 












e All instructions with longaddr operand formats: 


Resulting register 
Coded format displacement format USING range 


addr (reg’”” , waddr) —32767 to +65535 
(reg!~? , waddr)* —32767 to +65535 












e The MVWS instruction: 


Resulting register 
Coded format displacement format USING range 


addr (reg®-3, wdisp) 0 to 62 
(reg°"*, wdisp)* 






5-40 SC34-0074 


e The BALS instruction: 


Resulting register 
Coded format - displacement format USING range 
e The BXS instruction: 


Resulting register 
Coded format displacement format USING range 

















—256 to +254 





Here is some sample code that illustrates the range of the USING instruction: 


* INSTRUCTION 
gia 


MYPROG 


START 


MVA DATA, R2 
USING DATA,R2 


MVWS FIELDI,RI 


MVW ~~ FIELD2,R6 


-CSECT 


pS ted 


CSECT 
DS F 


DESCRIPTION 





LOAD BASE ADDRESS INTO REGISTER 
SPECIFY BASE ADDRESS AND ASSIGN 
REGISTER 


FIELD] WITHIN USING RANGE SO _ 
ADDRESS CONVERTS PROPERLY — 


CANNOT CONVERT ADDRESS EVEN THOUGH | 
FIELD2 1S WITHIN 65535 BYTES OF DATA. 
BECAUSE FIELD2 IS NOT IN THE SAME | 
CONTROL SECTION | eee Nae 


USING RANGE STARTS HERE AND IS 65535. 
BYTES OR LESS, DEPENDING ON THE 
BOUNDARIES OF THE CONTROL SECTION . 


AND THE INSTRUCTIONS CODED 
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The domain of a USING instruction (called the USING domain) begins where the 
USING instruction appears in a source module and continues to the end of the source 
module. (Exceptions are discussed later in this chapter in “Notes About the Using 
Domain.”’) The assembler converts addresses in instructions into register-displacement 
form only when: 

e The instructions appear in the domain of a USING instruction, and 
e The addresses referred to are within the range of the same USING instruction. 

The USING domain depends on the position of the USING instruction in the source 

module after macro expansion, if any, occurred. 


—& INSTRUCTIONS DESCRIPTION 
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* 

MYPROG START 
MVA DATA, R2 
MVW = FIELD, R6 CANNOT CONVERT ADDRESS 
USING DATA,R2 USING DOMAIN STARTS HERE 
MVW  FIELD,RS CAN CONVERT ADDRESS 

DATA _—CSECT 

FIELD DC x'1g! 

| END USING DOMAIN ENDS HERE 


You should specify your USING instructions so that: 


e As many data items as possible are grouped within a USING range, and 
e All the instructions that refer to these data locations are within the corresponding 
USING domain. 

You should therefore place USING instructions at the beginning of your coded 
instruction sequences and specify a base address in each USING instruction for each 
USING range you require. You can use the same register in multiple USING instructions 
so long as you load the register each time the required address changes. 


* INSTRUCTIONS — | DESCRIPTION 
a MVA DATA,R2  =--——SsSLOAD BASE ADDRESS INTO REGISTER 
1 USING DATA,R2 SPECIFY BASE ADDRESS AND. ASSIGN 
* REGISTER 
: : MACHINE INSTRUCTIONS HERE 
DATA «QU. * 
: DATA ITEMS HERE 
END 
For reference control sections. The next example shows how to establish addressability 
for a dummy section (a reference control section defined by a DSECT instruction). The 
address you load into the register at execution time must be the base address specified in 
the USING instruction. Note that the assembler assumes you are referring to the symbolic 
addresses in the dummy section, and it computes displacements accordingly. However, at 
execution time, the assembled addresses refer to the location of real data in the storage 
area. The USING range in the next example is the reference control section—from the 
DSECT instruction to the END instruction. The USING domain is from the USING 
instruction to the END instruction. 
* INSTRUCTIONS | | DESCRIPTION 
* | | 
MVW ADCON,RI LOAD BASE ADDRESS INTO REGISTER 
USING DUMMY ,RI SPECIFY BASE ADDRESS AND ASSIGN 
* REGISTER _ 
ADCON DC V (EXTERNAL) 
MV FIELD, R6 
DUMMY SECT USING RANGE STARTS HERE _ 
FI ELD DS F in 
END USING RANGE ENDS HERE 


For executable control sections. The next example shows a way to establish 
addressability for an executable control section. The USING domain starts with the 
USING instruction and continues to the END instruction; the USING range (maximum) 
is from 32767 bytes before the EQU instruction to 65535 bytes after the EQU 
instruction. 
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USING Instruction Format 
The format of the USING instruction is: 


The name field of the USING instruction must be blank. The address specifies a base 
address, which must be a relocatable expression. The value of the expression must be in 
the range O—65535. The register can be specified by an absolute register expression whose 
value is in the range O—7. The assembler assumes that the register contains the base 
address at execution time (the USING instruction does not load the address into the 
register). 

Coding Note. If you use the MVA instruction to load the base register, code it before the 
USING instruction. That prevents the following error: 









USING DATA,RI 
MVA —— DATA,RI 


DATA EQU x 


In this example, the MVA is in the domain of the USING, so the assembler computes a 
displacement of 0 for DATA, then generates the equivalent of: 


MVA (R1,0)R1 | 


Since RI does not already contain the address of DATA, unpredictable results will 
Occur at execution time whenever R1 is used as a base register. Code this instead: 


MVA DATA, RI 
USING DATA,RI 


DATA EQU sx 
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* INSTRUCTIO 
* 
US | 


DATA —-EQU 
DRO 
DATA2 —-EQU 
US| 
Us| 


END 


* INSTRUCTIO 
* 


US | 


US | 


DATA EQU 


@ 


END 


Notes About the USING Domain. The domain of a USING instruction continues until the 
end of a source module except when: 
e A subsequent DROP instruction specifies the same register assigned by the USING 
instruction. 
e A subsequent USING instruction specifies the same register assigned by the preceding 
USING instruction. 
In the following example, instructions cannot be converted to register-displacement 
form between the DROP instruction and the second USING instruction. 


NS DESCRIPTION 
NG DATA,RI FIRST USING DOMAIN STARTS HERE 
* 
P RI FIRST USING DOMAIN ENDS HERE 
* 
NG DATA,R2 SECOND USING DOMAIN STARTS HERE 
NG DATA2,R2 SECOND USING DOMAIN ENDS HERE, AND 
THIRD USING DOMAIN STARTS HERE 
THIRD USING DOMAIN ENDS HERE 


Notes About the USING Range. Two USING ranges coincide when the same base address 
is specified in two different USING instructions, even though the registers are different. 
When two USING ranges coincide, the assembler uses the lower numbered register for 
assembling the addresses within the common USING range. (The first USING domain 
terminates at the second USING instruction.) 


NS DESCRIPTION 


COINCIDE START 


NG DATA,R2 
INSTRUCTIONS HERE USE R2 AS 
A BASE REGISTER 

NG DATA,RI 7 
INSTRUCTIONS HERE USE RI AS 
A BASE REGISTER 

* 

INSTRUCTIONS HERE USE RI AS 
A BASE REGISTER 
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DROP—Drop Base Register 


Two USING ranges overlap when the range of one USING instruction is within the 
range of another USING instruction. When two ranges overlap, the assembler computes 
displacements from the base address using the lower-numbered register when it assembles 
the addresses within the range overlap. This applies only to instructions that appear after 
the second USING instruction. 


The DROP instruction terminates the USING domain for one or more registers. Use the 

DROP instruction to: 

e Free registers for other purposes. 

e Ensure that the assembler uses the base register desired in a particular coding situation 
(as when two USING ranges overlap or coincide, as described in “Notes About the 
Using Range.’’) 

The format of the DROP instruction is: 


DROP 1—8 absolute register expressions, separated by commas 


The name field of the DROP instruction must be blank. Up to 8 register expressions can 
be specified on one DROP instruction; the expressions must be absolute with a value in 
the range O—7. 

After a DROP instruction, the assembler no longer uses the dropped register as a base 
register. A register made unavailable as a base register by a DROP instruction can be 
reassigned as a base register with a subsequent USING instruction. For example: 





* INSTRUCTIONS DESCRIPTION 


* 


DATA 
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USING DATA,R2 


DROP R2 


USING DATA,R2 


Og 


EQU * 


R2 AVAILABLE FOR USE AS A 
BASE REGISTER HERE 


R2 UNAVAILABLE FOR USE 
AS A BASE REGISTER HERE 


R2 AVAILABLE FOR USE AS A 
BASE REGISTER HERE 


END 


You need not use a DROP instruction: 


e If you reassign a register in a new USING instruction (however, you must load the new 


base address into the register). 


e At the end of a source module. 


* INSTRUCTIONS DESCRIPTION 

* 
MVA = DATA, RI LOAD BASE ADDRESS INTO REGISTER 
USING DATA,RI SPECIFY BASE ADDRESS AND 

* ASSIGN REGISTER 
MVA DATA2,R1 LOAD NEW BASE ADDRESS INTO REGISTER 
USING DATA2,R1 SPECIFY NEW BASE ADDRESS AND 

* ASSIGN REGISTER 

DATA EQU * 

DATA2 EQU * 
END 


SYMBOLIC ADDRESSING BETWEEN SOURCE 

MODULES—SYMBOLIC LINKAGE 

This section describes symbolic linkage; that is, using symbols to communicate between 
different source modules that are separately assembled and then linked together by the 
linkage editor. 


1. 


To establish symbolic linkage with an external source module: 


You must identify the symbols that are not defined in your source module. These 
symbols are called external symbols, because they are defined in another (external) 
source module. You can identify external symbols: 

— Explicitly with the EXTRN or WXTRN instruction 

— Implicitly with the V- or W-type address constants 

— With the BALX and BX machine instructions 

You must provide the A-, V-, or W-type address constants so the assembler can reserve 
Storage for the addresses of the external symbols. When you use a BALX or BX 
instruction you do not provide an address constant; the address area is part of the 
instruction. 

To resolve linkages, you must identify the symbols in the external source modules 
where you have them defined. These symbols are called entry symbols because they 
provide points of entry to a source module. You identify entry symbols with the 
ENTRY, CSECT, or START instruction. 


Assembler Instructions 5-47 


The assembler places information about entry and external symbols in the external 
symbol dictionary. The linkage editor uses this information in conjunction with the 
relocation dictionary to resolve the linkages. 

The following example illustrates symbolic linkage between three source modules: 


* INSTRUCTIONS DESCRIPTION 

. | 

REFERX START START OF FIRST SOURCE MODULE 
EXTRN ONE,TWO 
WXTRN THREE 


BALX FOUR,R7 


ADCONS EQU) * 
oC A(ONE , TWO, THREE) 


DC — sd (FIVE) 

DC W(S1X) 

END ONE END OF FIRST SOURCE MODULE 
DEFINE | START START OF SECOND SOURCE MODULE 

ENTRY ONE,TWO,THREE,FOUR | 
ONE EQU  * 
TWO EQU # 


THREE EQU * 
FOUR EQU * 
END END OF SECOND SOURCE MODULE 


DEFINE2 START START OF THIRD SOURCE MODULE 
‘ENTRY FIVE,SIX | 


FIVE EQU * 


SIX EQU. * 


END END OF THIRD SOURCE MODULE | 
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To Refer to External Data 


* INSTRUCTIONS” - DESCRIPTION 


REFERX 


ADCON 


DUMMY 


DEFINE 


DATA _ 
FIELD] 


You should use the EXTRN instruction to identify the external symbol that represents 
data in an external source module, if you wish to refer to this data symbolically. 

For example, you can identify the address of a data area in an external source module 
as an external symbol and load the address constant for this symbol into a register. Then 
you may use this register when establishing the addressability of a dummy section 
(DSECT) that defines this external data area. You can now refer symbolically to data in 
the external area. You must also identify, in the source module that contains the data 
area, the same relative address of the data as an entry symbol. 

In the following example, FIELD3 is assembled as part of the DEFINE source module 
(second source module); a dummy section in the REFERX source module (first source 
module) is used to refer to FIELD3; and, after link-editing the two source modules 
together, both source modules can access FIELD3. 





START | FIRST SOURCE MODULE STARTS HERE 


EXTRN DATA 
MVW  ADCON, R2 


USING DUMMY ,R2 


MVWR3, FIELD3 FIELD3 REFERRED TO HERE ——t™~*S 


oC A(DATA) 


_ OSECT DUMMY SECTION STARTS. HERE. ie ctee 
aeaeees FIELD3 DEFINED HERE be ALLMAN 
END 


“START | SECOND SOURCE MODULE STARTS HERE 
ENTRY DATA | . fe 7 


oc OF ‘I 


DC CX! FFP" 
oc Fg! FIELD3 ASSEMBLED HERE 


END SECOND SOURCE MODULE ENDS HERE 
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To Branch to an External Address 


You can use the BALX or BX machine instruction to branch to a location in an external 
source module. Code the external symbol as an operand in these instruction types. 

You can also use the V-type address constant to identify the external symbol. For 
example, you can branch to an external address by branching indirectly with the V-type 
address constant. For the specifications of the V-type address constant, see “Defining 
Data” in this chapter. 

If the external symbol is the label of a START or CSECT instruction in the other 
source module, and thus names an executable control section, it is automatically 
identified as an entry symbol. If the symbol represents an address in the middle of a 
control section, you must, however, identify it as an entry symbol in the external source 
module. For example: 








* INSTRUCTIONS | DESCRIPTION Bets 
REFERX START START OF FIRST nemeiarriii 
BX SUBRTN BRANCH TO EXECUTE SUBROUTINE 
pe Re AMM MBean i 
a END END OF FIRST SOURCE - MODULE 
MOD2 START START OF SECOND SOURCE. NODULE 
ENTRY SUBRTN 
SUBRTN EQU + sou 
END END OF SECOND SOURCE MODULE = 


You can also use a combination of an EXTRN instruction to identify, and an A-type 
address constant to contain the external branch address. However, the external branch 
instruction, or the V- or W-type address constants, is more convenient because you do not 
have to code an EXTRN instruction. With external branch instructions, you also do not 
code an address constant. | | 

The assembler does not consider the symbol in a V-type or W-type constant, as defined 
in the source module. Therefore, you can use the same symbol as the name entry for any 
statement in the same source module, even the DC statement defining the V-type or 
W-type constant. 


ENTRY-—Identify Entry Point Symbol 
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ENTRY identifies symbols defined in the source module containing the ENTRY 
instruction so that you can refer to them in another source module. These symbols define 
locations that are called entry points. 

The format of the ENTRY instruction is: 








one or more relocatable symbols 
(entry symbols), separated by. commas 






The label of an ENTRY instruction must be blank. 
The following rules apply to entry symbols: 
e They must be valid symbols. 
e You must define them in an executable control section within the current assembly. A 
symbol can appear on multiple ENTRY statements within an assembly. 

A symbol used as the label of a START or CSECT instruction is also automatically 
considered as an entry point and does not have to be identified by an ENTRY 
instruction. Thus, in the following example, the two entry points are FIRST and 
SUBRTIN. 


FIRST | START 
ENTRY SUBTRN 


SUBTRN EQU * 
END 


The assembler lists each entry symbol in the external symbol dictionary, along with 
other entries for external symbols. 


EXTRN—Identify External Symbol 
EXTRN identifies symbols referred to in the source module containing the EXTRN 
instruction but defined in another source module. These symbols are called external 
symbols. 
The format of the EXTRN instruction is: 


The label of an EXTRN instruction must be blank. 
The following rules apply to the external symbols: 
e They must be valid symbols. 
e You must not use them as the name entry of any source statement in the same source 
module. 
e You must use them alone and not pair them in an expression, except within A-type 
address constants. 
The assembler lists each external symbol in the external symbol dictionary, along with 
entries for entry symbols. The maximum number of external symbol dictionary entries 
you can have in one source module (excluding ENTRY symbols) is 255. 








one or more relocatable symbols 
(external symbols), separated by commas 
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Note. Symbols you specify in V-type address constants and external branch instructions 
are implicitly identified as external symbols and count toward the maximum of 254. 

The following example indicates the relationship of ENTRY and EXTRN statements. 
Note that FOURTH need not be specified in an EXTRN statement since it is a V-type 
address constant in FIRST, and that SECOND need not be specified on an ENTRY 
statement since it is the label on the START statement. 


FIRST START 
EXT RN- SECOND , THIRD 


EXTAD] DC  A(SECOND) 
EXTAD2 DC A(THIRD) 
EXTAD3 DC _-V(FOURTH) 
| END 
SECOND START 

ENTRY THIRD ,FOURTH 





THIRD EQU * 
FOURTH EQU. * 
END 


WXTRN-Identify Weak External Symbol 
WXTRN identifies symbols in the source module containing the WXTRN instruction but 
defined in another source module. As with the EXTRN instruction, the linkage editor can 
resolve the linkage addresses only if the external symbols in the WXTRN operand field 
are defined in a module that is linked to your object module by way of linkage editor 
INCLUDE statements 
The format of the WXTRN instruction statement is: 


blank WXTRN one or more relocatable symbols (weak external 
symbols), separated by commas 


The label of a WXTRN instruction must be blank. 

To the assembler, the external symbols identified by a WXTRN instruction have the 
same properties as the external symbols identified by the EXTRN instruction. However, 
the type code assigned to these external symbols in the external symbol dictionary is 
different. If the linkage editor cannot resolve a weak external symbol, it prints a warning 
message rather than an error message. 
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If you specify a symbol in a V-type address constant and also in a WXTRN instruction 
in the same source module, the symbol is processed as a weak external reference. If you 
specify an external symbol by both an EXTRN and WXTRN instruction in the same 
source module, the first declaration takes precedence, and subsequent declarations are 
flagged with error messages. You may use the same symbol in multiple EXTRN and 
external branch instructions. You may also duplicate a symbol in WXTRN instructions. 
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CONTROLLING THE ASSEMBLER PROGRAM 


ORG-—Set Location Counter 


The ORG instruction alters the setting of the location counter and thus controls the 
structure of the current control section. This allows you to redefine parts of a control 
section. : 

The ORG instruction can cause the location counter to point to any part of a control 
section, where you can assemble desired data. It can also cause the location counter to 
point back to the next available location so that your program can continue to be 
assembled in a sequential fashion. 

The format of the ORG instruction is: 


relocatable expression OR blank 
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The label of an ORG instruction must be blank. The symbols in the relocatable 
expression must be previously defined in the source module. If the expression contains an 
unpaired relocatable term, you must define that term in the same control section in 
which the ORG statement appears. The location counter is set to the value of the 
relocatable expression. If the expression is omitted, the location counter is set to the next 
available location for the current control section. The following sample code illustrates 
the setting of the location counter with the ORG instruction: 


[Smet 





—ANITIAL,R7 


G BUFFER — 


s(n”) 


ae 





You must not specify an expression on an ORG instruction for a location that precedes 
the beginning of the control section in which the ORG appears. In the next example, the | 
ORG instruction is invalid if it appears less than 100 bytes from the beginning of its 
control section. This is because the resulting expression would be negative and therefore 
invalid. 
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CHAR 


Listing Format and Output 


PRINT—Print Optional Data 


Note. Using the ORG instruction to insert data at the same location as earlier data does 
not always work. In the next example, it appears as if the character constant overlays the 
address constant. However, after the linkage editor places the character constant into the 
same location as the address constant, it adds the relocation factor required for the 
address constant to the value of the constant. This sum is the object code that resides in 
the word ADDR. 


A(LOC) 


ORG *=2 


C'BE' 


You will experience unpredictable results when you code an ORG statement to insert 
data in any relocatable machine instruction. 


The PRINT, TITLE, EJECT, and SPACE instructions request the assembler to produce 
listings and identify records in the object module according to your special needs. They 
allow you to determine printing and page formatting options other than the ones the 
assembler program assumes by default. Among other things, you can introduce your own 
page headings, control line spacing, and suppress unwanted detail. 


PRINT controls the amount of detail you want printed in the listing of your program. 
The three options that you can set are given in the following table. They are listed in 
hierarchic order; if OFF is specified, GEN and DATA do not apply. If NOGEN is 
specified, DATA does not apply to the constants in generated statements. The standard 
options inherent in the assembler program are ON, GEN, and NODATA. 


A listing is printed 


No listing is printed 


All statements generated by the processing of a macro 
instruction are printed 


Statements generated by the processing of a macro 
instruction are not printed. (Vote. the MNOTE 
instruction always causes a message to be printed) 


DATA Constants are printed in full in the listing 


1 
1 
2 
2 
3 
3 


NODATA Only the leftmost 12 bytes of constants are printed 
in the listing 





The format of the PRINT instruction is: 


ON GEN DATA 
OFF NOGEN NO DATA 







The label of the PRINT instruction must be blank. At least one of the print options 
must be specified, and at most one of the options from each group. If more than one 
option is specified, they must be separated by commas. 
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The options can be specified in any order. The PRINT instruction can be specified any 
number of times in a source module. At assembly time, all options are in force until the 
assembler encounters a new and opposite option in a PRINT instruction. 

Note. The option specified in a PRINT instruction takes effect after the PRINT 
instruction. If PRINT OFF is specified, the PRINT instruction itself is printed, but not 
the statements that follow it. 


TITLE—Identify Assembly Output 


TITLE provides headings for each page of the assembly listing. 
The format of the TITLE instruction is: 


id 
TITLE 


The label field of the first TITLE instruction in a program can contain identification 
characters. Up to four identification characters are placed in the object module starting in 
column 73, and are printed in the top left-hand corner of every page of the listing. 
Specifying a valid ordinary symbol in this field does not constitute a definition of that 
symbol for the source module. 





character string up to 100 characters, enclosed in 
apostrophes 





The character string on the TITLE instruction is printed as a heading at the top of each 
page of the assembly listing. The heading is printed beginning on the page in the listing 
following the page on which the TITLE instruction is specified. A new heading is printed 
when a subsequent TITLE instruction appears in the source module. 

Any printable character specified will appear in the heading, including blanks. However, 
the following rules apply to apostrophes: 

e A single apostrophe followed by one or more blanks simply terminates the heading 
prematurely. If a nonblank character follows a single apostrophe, the assembler issues 
an error message and does not print a heading. 

e Double ampersands or apostrophes print as a single ampersand or apostrophe in the 
heading. | 

Only the characters printed in the heading count toward the maximum of 100 
characters allowed. 


Note. The TITLE statement itself is not printed in an assembly listing. 


EJECT—Start New Page 


EJECT stops the printing of the assembly listing on the current page and continues the 
printing on the next page. 
The format of the EJECT instruction is: 


= 


The label on an EJECT instruction must be blank. The EJECT instruction causes the 
next line of the assembly listing to be printed at the top of a new page. If the line before 
the EJECT instruction appears at the bottom of a page, the EJECT instruction has no 
effect. 


Note. The EJECT instruction is not printed in the listing. 
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SPACE—Space Listing 


SPACE inserts one or more blank lines in the listing of a source module. This allows you 
to separate sections of code on the listing page. 
The format of the SPACE instruction is: 


The label on a SPACE instruction must be blank. 

The decimal value on the SPACE instruction specifies the number of lines to be left 
blank. A blank causes one blank line to be inserted. If the value specified is greater than 
the number of lines remaining on the listing page, the instruction has the same effect as 
an EJECT statement. 


Note. The SPACE instruction is not printed in the listing. 





decimal value from 1 to 255 OR blank 





\ Assembler Instructions 5-57 


5-58 SC34-0074 


Chapter 6. Macro Language 
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Macros are used mainly to insert defined groups of assembler language statements into a 
source program. The defined group of statements is a macro definition; the statements are 
either stored in a source file or placed at the beginning of the source module. This chapter 
explains how to prepare macro definitions as the first portion of your source module. 

The statements contained in the macro definition are called by macro instructions in 
your source program; the macro instruction is coded at the point you would otherwise 
include the statements contained in the macro definition. The calling macro instruction 
can specify parameters which change the statements contained in the macro definition. 
The assembler inserts the macro definition statements, as modified by the parameters on 
the calling macro instruction, immediately after the calling macro instruction. The 
process of inserting the text of the macro definition is called macro generation or macro 
expansion The expansion occurs for each macro instruction that calls the macro 
definition. 

The assembler processes the source module in two phases: 


e First, preassembly; during this phase the assembler expands macro calls by inserting 
text from macro definitions inline after the calling macro instructions. The statements 
contained in the macro definition can be modified during preassembly by assembler 
action as follows: 

— Processing symbolic parameters specified on the calling macro instruction to 
modify the statements in a macro definition which contain the same symbolic 
parameters. 

— Processing conditional assembly instructions contained within a macro definition; 
these instructions declare and assign values to SET symbols (symbols used to write 
source statements that can be modified during expansion) and allow for branching 
and loop control within a macro expansion. With conditional assembly language 
instructions, you can select and reorder the statements generated each time a macro 
is expanded. 

— Processing MNOTE instructions, which produce error messages that you provide. 

— Processing system variable symbols; these symbols can be used in macro definitions 
to cause the assembler to perform specific actions (for example, to count the 
number of symbolic parameters on a calling macro instruction so that the number 
can be used to determine further expansion of the macro). 

e Then, assembly; during this phase the assembler processes the source module (known 
as open code) and the statements generated during macro expansion at preassembly 
time, to produce the object module. 


By using the macro language you reduce programming effort, because: 


e You write and test the code for a macro definition only once. You and other 
programmers can then use the same code as often as you like by calling the definition; 
this means that you do not have to reconstruct the coding logic each time you use the 
code. 

e You need write only one macro instruction to call for the generation of many 
assembler language statements from the macro definition. 

When you are designing and writing large assembler language programs, the above 
features allow you to: 

e Change the code in one place when updating or making corrections, that is, in the 
macro definition. Each call gets the latest version automatically, thus providing 
standard coding conventions and interfaces. 

e Describe the functions of a complete macro definition rather than the function of each 
individual statement it contains, thus providing more comprehensible documentation 
for your source module. 
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You can create a macro definition by enclosing any sequence of assembler language 
statements between MACRO and MEND statements, and by writing a prototype 
statement in which you give your definition a name. This name is then the operation code 
that you must use in the macro call. | 

When you code a macro call in your source module, you tell the assembler to process a 
particular macro definition. The assembler generates assembler language statements from 
this macro definition for each occurrence of the macro call; if you code four calls to the 
macro MYMACRO, four sets of assembler language statements are generated. The 
statements generated can be: 


e Copied directly from the definition 

e Modified by parameter values before generation 

¢ Manipulated by internal macro processing to change the sequence in which they are 
generated 

e Selectively chosen or discarded in groups 


You can define your own macro definitions in which any combination of these 
processes can occur. Some macro definitions do not generate assembler language 
statements, but perform only internal processing. 

The MACRO and MEND instructions establish the boundaries of a macro definition. 
The prototype statement establishes the name of the macro and declares its parameters. 
In the operand field of the calling macro instruction, you can assign values to the 
parameters declared for the called macro definition. The body of a macro definition 
contains the statements that will be generated when you call the macro. These statements 
are called model statements; they are usually interspersed with conditional assembly 
statements or other processing statements. 

You can include a macro definition at the beginning of a source module. This type of 
definition is called an inline macro definition. You can also insert a macro definition in a 
macro source file (located on a fixed disk). This type of definition is called a source file 
macro definition. 

The following example indicates the general format of a macro definition within a. 
source module: 





| p SPARAMI, &PARAM2 — 






"START OF OPEN cope 
CID OPERAND! ,OPERAND2 MACRO. CALL | 
WACID OPERANDS OPERAND MACRO. CALL 


END OF ‘SOURCE MODULE 


You can call an inline macro definition only from the source module in which it is 
included. You can call a source file macro definition from any source module. You can 
code a calling instruction anywhere in a source module, except before or between any 
inline macro definitions contained in that source module. You can-also call a macro 
definition from within another macro definition. This type of call is an inner macro call; 
it is said to be nested in the macro definition. | 


Contents of a Macro Definition 


Model Statements 


Processing Statements 


Comment Statements 


The body of a macro definition can contain a combination of model statements, 
processing statements, and comment statements. 


Model statements are assembler or machine instructions. As model statements, these 
instructions can use variable symbols as points of substitution. The macro assembler 
substitutes character string values in place of the variable symbols each time the macro is 
called. 

The assembler processes the generated statements, with or without value substitution, 
at assembly time. 

The 3 types of variable symbols in the assembler language are: 


e Symbolic parameters, which are declared in the prototype statement 
e System variable symbols 
e SET symbols, which are part of the conditional assembly language 


Processing statements perform functions at preassembly time when macros are expanded, 
but they are not themselves generated for further processing at assembly time. The 
processing statements are: 


e Conditional assembly instructions 
e Inner macro calls 

e MNOTE instructions 

e MEXIT instructions 


The MNOTE instruction allows you to generate an error message with an error 
condition code attached, or to generate comments in which you can display the results of 
preassembly operations. 

The MEXIT instruction tells the assembler to stop processing a macro definition. The 
MEXIT instruction provides an exit from the middle of a macro definition. The MEND 
instruction not only delimits the contents of a macro definition, but also provides an exit 
from the definition. 

The conditonal assembly language provides: 


Variables 

Data attributes 

Expression computation 

Assignment instructions 

Labels for branching 

Branching instructions 

Substring operators that select characters from a string 


You can use the conditional assembly language in a macro definition to operate on 
input from a calling macro instruction. You can use the functions of the conditional 
assembly language (1) to select statements for generation, (2) to determine their order of 
generation, (3) to perform computations that affect the content of the generated 
statements, and (4) to produce preassembly messages through the MNOTE instruction. 
The conditional assembly language is fully described in this chapter. 


Note. Conditional assembly instructions can be used only within macro definitions. 


A macro definition can contain two types of comment statements—one type describes 
preassembly operations and is not generated when the macro is expanded; the other type 
describes assembly operations and is generated. For details, see ‘““Comment Statements in 
Macro Definitions.” When a macro definition is called, the assembler generates assembler 
language statements. 
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Where To Place a Macro Definition in the Source Module 


Parts of a Macro Definition 
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A macro definition within a source module must be at the beginning of that source 
module. 

Open code is that part of a source module that is outside of and after any inline macro 
definition. Open code is initiated by any statement of the assembler language that appears 
outside of a macro definition, except the EJECT, PRINT, SPACE, or TITLE instructions 
Or a comment statement. Statements that do not start open code and comment 
statements can appear at the beginning of a source module: 

e Before all macro definitions 
e Between macro definitions 
e After macro definitions and before open code 

All other statements of the assembler language must appear after any inline macro 

definitions that are specified. 


A macro definition consists of a header, prototype statement, body, and trailer. 


Macro header. The MACRO instruction is the macro definition header; it must be the first 
statement of every macro definition. Its format is: 


Prototype statement. The prototype statement in a macro definition serves as a model 
(prototype) of a macro instruction used to call the macro definition. The prototype 
statement must be the second statement in every macro definition. It comes immediately 
after the MACRO instruction. The format of the prototype statement is: 


macro 
[label ] name 


where label can be a symbolic parameter or blank. 








zero to 100 symbolic parameters, separated by commas 





Body of macro. The machine instructions generated during macro expansion are 
determined by the machine, assembler, and conditional assembly instructions coded 
between the prototype statement and macro trailer. 


Macro trailer. The MEND instruction indicates the end of a macro definition. It also 
provides an exit when it is processed during macro expansion. Its format is: 


where /abel can be a symbolic parameter or blank. 





Coding the Prototype Statement 

If no parameters are specified on the prototype statement, remarks are not allowed. 
Remarks are allowed after parameters, if preceded by at least one blank. To intersperse 
remarks with parameters (for example, a remark for each parameter), use continuation 
lines as shown below. Any number of continuation lines is allowed. However, each 
continuation line must be indicated by a nonblank character in column 72 on the 
preceding input record. For each continuation line, the symbolic parameters must begin 
in column 16; otherwise, the whole line and any lines that follow are considered to 
contain remarks. For example: 


MOVE) «TO, REMARKS 
— SFROM, REMARKS 
_ SLENGTH, == ———_—REMARKS 


__SPARAM, EPARAM2 ,&PARAM3, REMARKS 








Prototype label. You can write a parameter, similar to a symbolic parameter, as the label 
of a macro prototype statement. You can then assign a value to this parameter from the 
name entry in the calling macro instruction. If used, the label must be a variable symbol. 
If this parameter also appears in the body of a macro, it is given the value assigned to the 
parameter in the label of the corresponding macro instruction. For example: 


% INSTRUCTIONS DESCRIPTION 
| MACRO 
ENAME — INTRCHG &T0,&FROM PROTOTYPE STATEMENT 


6NAME  MVW RI,SAVE 
MVW  &FROM,RI 
MVW = -&TO, &FROM 
MVWW ORI, ETO 
MVW  SAVE,RI 








MEND 
START ae eee Linien ys 
HERE | INTRCHG RESULT,DATA MACRO CALL THAT GENERATES si ass—t*S 
| FOLLOWING STATEMENTS: 


HERE MVW RI,SAVE 
MVWDATA,RE 
MVW RESULT,DATA 
MVW SAVE,RI seue 


m ee oe e608 e806 ee ee 98 se 


Note that the value assigned to the label parameter on the prototype statement has 
special restrictions that are listed in this chapter under “Using the Calling Macro 
Instruction.” 
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The Body of a Macro Definition 


Symbolic Parameters 
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Prototype macro name. The macro name is a symbol that identifies the macro definition. 
When you specify it in the operation field of a source instruction, the appropriate macro 
definition is called and processed by the assembler. The operation code specified in the 
prototype statement (prototype macro name) must not be the same as that specified in: 


1. Any machine instruction. 

2. Any assembler instruction other than the macro call. 

3. The prototype statement of any other inline (or source file) macro definition. (If the 
name of a source file macro definition matches the name of one of your inline macro 
definitions, the assembler uses the inline definition.) 


Prototype symbolic parameters. The operand entry in a prototype statement can contain 
positional or keyword symbolic parameters. These parameters represent the values passed 
from the calling macro instruction to the statements within the body of a macro 
definition. (See “Symbolic Parameters” in this chapter.) 


Note. The operands must be symbolic parameters; parameters in sublists are not allowed. 
For a discussion of sublists in macro instruction operands, see “Sublists in Operands” in 
this chapter. 


The body of a macro definition contains the sequence of statements that are the working 
part of a macro, including: 


¢ Model statements to be generated 

e Processing statements that, for example, can alter the content and sequence of the 
statements generated or issue error messages 

¢ Comment statements, some of which are generated and others which are not 

e Conditional assembly instructions to compute results to be displayed in the message 
created by the MNOTE instruction, without causing any assembler language 
statements to be generated 


The statements in the body of a macro definition must appear between the macro 
prototype statement and the MEND statement. 


Symbolic parameters (recognized by an ampersand as initial character) are declared in the 
macro prototype statement and serve as points of substitution in the body of the macro 
definition. During macro expansion, they are replaced by the values assigned to them by 
the calling macro instruction. By using symbolic parameters with meaningful names, you 
can indicate the purpose for the parameters (or substituted values). 

Symbolic parameters must be valid variable symbols, consisting of an ampersand 
followed by an alphabetic character, followed by O—6 alphameric characters (maximum 
of 8 characters total). They have a local scope; that is, the value they are assigned only 
applies to the macro definition in which they have been declared. The value of the 
parameter remains constant throughout each processing of the containing macro 
definition, changing with each call to the macro definition based on values assigned by 
each macro call. 


Note. Symbolic parameters must not be defined in duplicate or be identical to any other 
variable symbols within the given local scope. (This applies to system variable symbols, 
and local and global SET symbols described later in this chapter.) 


There are 2 kinds of symbolic parameters: 
e Positional parameters; for example: 


Prototype: MYMAC &PARM1,&PARM2 
Calling macro: MYMAC FIELDA,FIELDB 
e Keyword parameters; for example: 
Prototype: MYMAC2 &TO=,&FROM= 
Calling macro: MYMAC2 TO=FIELDA,FROM=FIELDB 
The two types of symbolic parameters may be mixed; for example: 
Prototype: MYMAC &PARAM1,&FROM= 
Calling macro: MYMAC FIELDA,FROM=FIELDB 


All positional parameters must precede any keyword parameters, if the two kinds are 
mixed on a prototype statement. 

If a parameter is positional on the prototype statement, it must be positional on the 
calling macro instruction; likewise, if keywords are used on the prototype statement, they 
must also be used on the calling macro instruction. Positional parameters on the calling 
macro instruction must appear in the same sequence as corresponding positional 
parameters on the prototype statement. Keyword parameters on the calling macro 
instruction do not have to appear in the same sequence as specified on the prototype 
statement, but must follow any positional parameters on the same calling macro 
instruction. 

Which kind of parameters should you use—positional or keyword? There are advantages 
to each: 


Positional. You should use a positional parameter if the value of the parameter changes 
with each calling macro instruction. Less coding is required to supply the value for a 
positional parameter than for a keyword parameter, since you code only the value; with 
keyword parameters, you must also code the keyword and equal sign. 


Keyword. You should use keyword parameters if you have a large number of parameters. 
The keywords make it easier to identify which values are being assigned to which 
parameters on the calling macro instruction in any order. You should also use a keyword 
parameter if the value changes infrequently. Keyword parameters can be initialized to 
default values in the prototype statement; then if the calling macro instruction does not 
change that default value, it need not contain that parameter. For example: 


Prototype: MYMAC &TO=FIELDA,&FROM=FIELDB 
Calling macro: MYMAC TO=FIELDC 
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Values are assigned to keyword parameters as follows: 


e If the corresponding keyword appears on the calling macro instruction, the value after 
the equal sign is the value for the parameter in that macro expansion. 

e If the corresponding keyword does not appear on the calling macro instruction, the 
default value from the prototype statement is the value for the parameter in that 
macro expansion. 





* INSTRUCT IONS Beas theo DESCRIPTION | 
Wil 
MACRO | sae 
KEYS © SKEY]=ABC KEY2=(A B ) PROTOTYPE STATEMENT : 
REND 
uel tied. vii Heeechaage ene 
: KEYS MACRO CALL THAT GeNERATES cane : 
ew _ USING THE FOLLOWING VAWUESS LLL 
: s«SKEYISABC | 
: &SKEY2= (A,B, Cc). 
KEYS KEY1=DEF, KEY2=(D,E, F) MACRO CALL THAT GENERATES. CODE. sna8 
7 USING THE FOLLOWING MARMESS 
:  -§KEYI=DEF ae 
Be aco eee — SKEY2=(D,E,F) 
END 


Note. A null character string can be specified as the default value of a keyword parameter 
and will be generated if the corresponding keyword operand is omitted. 


eee ONS DESCRIPTION 


MACRO peteeccaenene 
FXDPT &TYPE=, &REG=R3 PROTOTYPE STATEMENT==NULL CHARACTER 





STRING DEFAULT VALUE FOR | STYPE 


BALSTYPE ADDR, &REG 


B&ETYPE ADDRESS 
2 MEND 
OPEN START 


FXDPT MACRO CALL THAT GENERATES 


FXD 


(tt ee ee 68 c8 ee 


= 
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Subscripted Symbolic Parameters 


THE FOLLOWING CODE: 


BAL ADDR,R3 


B ADDRESS 


PT TYPE=xX MACRO CALL THAT GENERATES 
THE FOLLOWING CODE: 


BALX ADDR,R3 


BX ADDRESS 


Symbolic parameters may have several values expressed as a sublist rather than a single 
value. In this case, the symbolic parameter is written with a subscript, in the following 
format: 


&PARAM(subscript) 


where &PARAM is a valid variable symbol and subscript is an arithmetic expression (as 
described later in this chapter under “Arithmetic (SETA) Expressions’’), The subscripted 
arithmetic expression can contain other subscripted variable symbols; nesting of 
subscripted variable symbols is allowed for up to five levels. The value of the subscript 
must be greater than or equal to 1. 

The subscript on the prototype statement indicates the number of entries in the value 
sublist. The subscript in the body of the macro definition (when the symbolic parameter 
is used on a model statement) indicates the position of one entry in the sublist; if a 
symbolic parameter is subscripted on the prototype statement and nonsubscripted on a 
model statement, the model statement refers to the entire sublist (all entries). Sublists as 
values in calling macro instructions are fully described later in this chapter under 
“*Sublists in the Macro Instruction Operand.”’ 
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Model Statements 


Assembler language instructions are generated from model statements at preassembly 
time. By specifying variable symbols as points of substitution in a model statement, you 
can vary the content of the instruction generated from that model statement. 

A model statement consists of the same fields as an ordinary assembler language 
statement: name, operation, operand, and remarks. You cannot generate the 
identification and sequence field from a model statement. Model statements must have an 
entry in the operation field, in order to generate valid assembler language instructions. 
Each field or subfield can consist of: 

e An ordinary character string . 

e A variable symbol as a point of substitution 

e Any combination of ordinary character strings and variable symbols to form a 
concatenated string. 


The statements generated at preassembly time from model statements must be valid 
machine or assembler instructions, and must not be conditional assembly instructions. 
They must obey the coding rules described in Chapter 2 or they will be flagged as errors 
at assembly time. Generated statements are always printed in standard statement format. 
Because of this, a generated statement can occupy up to two continuation lines on the 
listing, unlike source statements, which are restricted to one continuation line. 


Variable Symbols as Points of Substitution 


Values can be substituted for variable symbols that appear in the name, operation, and 
operand fields of model statements; thus, variable symbols represent points of 
substitution. The three main types of variable symbols are: 

e Symbolic parameters (positional and keyword) 

e System variable symbols (&SYSLIST, &SYSNDX, and &SYSPARM) 

e SET symbols (global SETA, SETB, SETC and local SETA, SETB,SETC) 

Symbolic parameters, SET symbols, and the system variable symbol &SYSLIST can all 
be subscripted. The remaining system variable symbols &SYSNDX and &SYSPARM cannot 
be subscripted. | 

When values are substituted for variable symbols, the generated fields begin in standard — 
columns, if possible. 
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Rules for Concatenation 


When variable symbols are concatenated to ordinary character strings the following rules 
apply to the use of the concatenation character (a period). 


e The concatenation character is mandatory when: 
— An alphameric character is to follow a variable symbol 
— A left parenthesis that does not enclose a subscript is to follow a variable symbol. 
— A period (.) is to be generated. Two periods must be specified in the concatenated 
string following a variable symbol. 
e The concatenation character is not necessary when: 
— An ordinary character string precedes a variable symbol 
— A special character, except left parenthesis or period, follows a variable symbol 
— A variable symbol follows another variable symbol. 

The concatenation character must not be used between a variable symbol and its 
subscript; otherwise, the characters will be considered a concatenated string and not a 
subscripted variable symbol. 

Following are examples of concatenated strings and the resulting generated code: 


&FIELD.A & FIELD: AREA AREAA 





&FIELDA &FIELDA: SUM 


&DISP.(& BASE) &DISP: 100 100 (10) 
& BASE: 10 

DC F'INT.. &FPACT’ &INT: 99 DC F°99.88’ 
&FRACT: 88 

DC F‘&INT&FRACT’ &INT: 99 DC F‘'9988’ 
&FRACT: 88 

DC F‘&INT.&FRACT’ &INT: 99 DC F‘9988° 
&FRACT: 88 


&A+ &B* 3-D &A: A A+B*3-D 
&B: B 

&A&B &A: A AB 
&B: B 

&SYM(&SUBSCR) &SUBSCR: 10 ENTRY 













&SYM (10): ENTRY 
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Contents of Model Statement Name Field 
The entries allowed in the name field of a model statement are: 
e Blank 
e Ordinary symbol 
e Sequence symbol 
e Variable symbol 
e Any combination of variable symbols and other character strings concatenated 
The name field of the generated statement must contain a valid ordinary symbol or 
blank. Variable symbols must not be used to generate comment statement indicators (an 
asterisk in the “begin” column). 
Note. Restrictions on the name entry are further specified where each individual 
assembler language instruction is described in this manual. 


Contents of Model Statement Operation Field 
The entries allowed and not allowed in the operation field of a model statement are: 


Allowed Not allowed 


e Anordinary symbol that represents the operation ° Blank 


code for: e The assembler operation codes: 
—any machine instruction 

—a macro instruction MACRO 

—the following assembler instructions: END 


CSECT ENTRY START 
DC EQU TITLE 
DROP EQUR USING 
DS EXTRN WXTRN 
DSECT ORG PRINT 
EJECT SPACE 


A variable symbol 


_Acombination of variable symbols and other 
character strings concatenated together 





As a result, the entries allowed and not allowed in the operation field of the generated 
statements are: 


Allowed Not allowed 


e An ordinary symbol that represents the operation e Blank 
code for: 
—any machine instruction 
—the following assembler instructions: e A ee assembly operation 
code: 
CSECT ENTRY START ACTR LCLA 
DROP EXTRN TITLE AIF LCLC 


e Macro instruction operation code 


DS ORG USING ANOP SETA 
DSECT PRINT WXTRN CBLA SETB 
EJECT EQUR MNOTE GBLB SETC 


GBLC 


The following assembler 
operation codes: 


MACRO MEND 
END MEXIT 
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The MACRO and MEND operation codes are not allowed in model statements; they are 
used only for delimiting macro definitions. The END operation code is not allowed inside 
a macro definition. 

Note. The MNOTE and MEXIT statements are not model statements. The MNOTE 
operation code can, however, be created by substitution. 


Contents of Model Statement Operand Field 


The entries allowed in the operand field of a model statement are: 
Blank (if valid) 
e An ordinary symbol 
e A character string combining alphameric and special characters (but not variable 
symbols) 
A variable symbol 
A combination of variable symbols and other character strings concatenated 
The generated statement operand field must contain a blank or character string that 
represents a valid assembler or machine instruction operand. 


Contents of Model Statement Remarks Field 


Any combination of characters can be specified in the remarks field of a model 
statement. No values are substituted into variable symbols in this field. 


Examples of Model Statements 


EE MPRA DN DSA MERIDEN ANCAP REE NE Hee MESH 
g 
H Per 





Seta 


Model: 














Model: r ng 83, ADDR "REMARKS 


Caimated: ) R3, ADCON MA REMARKS 





‘REA - 





Model: MR 8c | 1S REGISTER COMPLEMENTED — 


Gera: -—=*~S*SMRO#RB._ 31S REGISTER COMPLEMENTED 


4 2 > «© >» & p 


Note. Generated remarks are combined with the operand field of model statement as in the example above. 


‘> 





- SETC ‘A CHR Rt 





Model: 


Generated: = "eK RRO R¥* | | : 
Note. The generated statement has no operation field. - | 
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Processing Statements 
The processing statements are: 
e Conditional assembly instructions 
e Inner macro instructions 
e MNOTE instructions 
e MEXIT instructions 


Conditional Assembly Instructions 
Conditional assembly instructions allow you to control at preassembly time the contents 
of the generated statements and the sequence in which they are generated. The 
instructions and their functions are: 


Conditional assembly instruction Function 


GBLA, GBLB, GBLC Declaration of initial value, type, and array dimensions 
LCLA, LCLB, LCLC for variable symbols (global and local SET symbols) 


SETA, SETB, SETC Assignment of values to variable symbols (SET symbols) 
AIF Conditional branch (based on logical test) 

AGO Unconditional branch 

ANOP Branch to next sequential instruction (no operation) 


ACTR Set loop counter 





Inner Macro Instructions 


Macro instructions can be nested inside macro definitions, allowing you to call other 
macros from within your own definitions. Nesting of macro instructions is fully described 
in ‘Nesting in Macro Definitions” in this chapter. 


MNOTE Instruction 


You can use the MNOTE instruction to generate your own error messages or display 
intermediate values of variable symbols computed at preassembly time. 
~The MNOTE instruction is used inside macro definitions and its operation code can be 
created by substitution. The MNOTE instruction causes the generation of a message 
which is given a statement number in the printed listing. 
The format of the MNOTE instruction statement is: 


[label ] MNOTE 








message specification 





The name field can contain a sequence symbol or blank. The message specification is 1 
of 4 options: 


Message specification Message produced 


n‘message’ error message, severity n(O — 255) 


, ‘message’ error message, severity 0 
‘message’ error message, severity 0 
* ‘message’ comments, severity 0 
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The n stands for a severity code. The rules for specifying the contents of the severity 
code subfield are as follows: 


e The severity code can be specified as a decimal self-defining term, or as a variable 
symbol representing a decimal self-defining term. The self-defining term must have a 
value in the range 0—255. 

e If the severity code is omitted, with or without the comma, the assembler assigns a 
default value of O as the severity code. 

e An asterisk in the severity code subfield causes the message and the asterisk to be 
generated as a comment statement. 

The following examples show the four options for MNOTE operands: 


e MNOTE 2,°ERROR IN SYNTAX’ 
Generates severity 2 diagnostic error message. 
e MNOTE ,“MISSING OPERAND’ 
Generates severity 1 diagnostic error message. 
e MNOTE ‘INVALID PARAMETER’ 
Generates severity 0 diagnostic error message. 
e MNOTE *,“DEFAULT IODA TAKEN’ 
Generates comments. 
An MNOTE instruction causes a message to be printed if the current PRINT option 
is ON, even if the PRINT NOGEN option is specified. 
Any combination of characters enclosed in apostrophes can be specified in the 
message subfield. The rules that apply to this character string are: 

e Variable symbols are allowed (variable symbols can have a value that includes even the 
enclosing apostrophes). 

e Double ampersands or double apostrophes are needed to generate one ampersand or 
one apostrophe. If variable symbols have ampersands or apostrophes as values, the 
values must have double ampersands or apostrophes. 

e Any remarks for the MNOTE instruction statement must be separated from the 
apostrophe that ends the message by one or more blanks. 

e Single apostrophes substituted or specified cause message generation to stop where the 
single apostrophe appears. If a single apostrophe is substituted in a position 
immediately after the closing apostrophe of the MNOTE instruction, then the 
apostrophe is printed. An error message is issued because a closing apostrophe cannot 
be found. 

The following examples indicate the results generated during preassembly processing of 

MNOTE instructions: 


MNOTE 3, ‘THIS IS A MESSAGE’ 3, THIS IS A MESSAGE 


MNOTE 3, PARAM 3, ERROR 
(&PARAM = ‘ERROR’) 


MNOTE 3, ‘VALUE OF &&A IS &A’ 3, VALUE OF &A IS 10 


(&A = 10) 


MNOTE 3, ‘DOUBLE & AMPS’ 3, DOUBLE & 
(&AMPS = &&) 


MNOTE 3, “DOUBLE &APOS’ 3, DOUBLE’ 
(&APOS = ‘’) 


MNOTE 3, ‘MESSAGE STOP’ RMRKS 3, MESSAGE STOP RMRKS 
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MEXIT Instruction 


The MEXIT instruction causes the assembler to exit from a macro definition to the next 
sequential instruction after the calling macro instruction. (This also applies to nested 
macro instructions.) Its format is: 


where name is either a sequence symbol or blank. 





Comment Statements In Macro Definitions 
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Macro definitions can contain two kinds of comment statements: 
e Internal macro comments—used to describe operations performed at preassembly time; 


not generated in the macro expansion 
e Ordinary comments—used to describe operations performed at assembly time; 


generated in macro expansion 
No values are substituted for variable symbols specified in either internal or ordinary 


comments. 
The format of an internal macro comment is: 


period (.) 
asterisk (*) 
textof comment (any character string) 







For example: 


«*THIS 1S AN INTERNAL MACRO COMMENT 
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The format for an ordinary comment statement within a macro definition is the same as 
for comment statements in open code (described in Chapter 2). 


System Variable Symbols 


There are three variable symbols whose values are set by the assembler according to 
specific rules; these are the system variable symbols: 


e &SYSLIST—to refer to positional parameter or sublist in the calling macro instruction 
when there is no corresponding parameter or sublist in the prototype statement and to 
count the number of positional parameters or items in a positional parameter sublist. 

e &SYSNDX—to generate unique symbols for each expansion of a macro definition, by 
concatenating to the symbol a suffix whose value changes for each expansion 

e &SYSPARM-—to refer to a parameter specified in the assembler options list. 


You can use these symbols as points of substitution in model statements and 
conditional assembly instructions. All system variable symbols are subject to the same 
rules of concatenation and substitution as other variable symbols (see “Model 
Statements’). System variable symbols must not be used as symbolic parameters in the 
macro prototype statement. Also, they must not be declared as SET symbols. The 
assembler assigns read-only values to system variable symbols; they cannot be changed by 
using the SETA, SETB, or SETC instructions (see “Declaring SET Symbols”). 

The system variable symbols &SYSLIST and &SYSNDX are assigned a read-only value 
each time a macro is called and have that value only within that expansion of the macro. 
The system variable symbol &SYSPARM is assigned a read-only value for an entire source 
module. 


&SYSLIST— Refer to Positional Parameters and Sublists 


By varying the subscripts attached to &SYSLIST, you can refer to any positional 
parameter or sublist entry in a calling macro instruction. &SYSLIST can refer to 
positional parameters that have no corresponding positional parameter in the macro 
prototype statement. &SYSLIST can also count the number of positional parameters or 
entries in a positional sublist that were given on the calling macro instruction. 

The assembler assigns read-only values to &SYSLIST each time a macro definition is 
called, applicable to that expansion of the macro only. &SYSLIST refers to the complete 
list of positional parameters in a calling macro instruction; &SYSLIST does not refer to 
keyword parameters. 

When used as a point of substitution within the macro definition, one of 2 forms of 
&SYSLIST must be used: 

e To refer to a positional parameter 
Calling macro instruction: 
MACLST P1,P2,...,Pn,.... 
Point of substitution: 
&SYSLIST(n) 
e To refer to a sublist entry in a positional parameter 
Calling macro instruction: 
MACSUB P1,P2,....,(Pn1,Pn2,....),... 
Point of substitution: 


&SYSLIST(n,m) 

The subscript n indicates the position of the parameter referred to. The subscript m, if 
specified, indicates the position of an entry in a sublist. The subscripts n and m can both 
be any arithmetic expression allowed in the operand of a SETA instruction; they must be 
greater than or equal to one. 
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If n refers to an omitted parameter or refers past the end of the complete list of 
positional parameters the null character string is substituted for &SYSLIST(n). If m refers 
to an omitted entry or refers past the end of the sublist, the null character string is 
substituted for &SYSLIST(n,m). Further, if the nth positional parameter is not a sublist, 
&SYSLIST(n, 1) refers to the nth parameter and &SYSLIST(n,m) causes the null 
character string to be substituted if m is greater than one. 

As an example of values substituted for &SYSLIST, consider the calling macro 
instruction: 


MACALL ONE,TWO, (3,4,,6),,EIGHT 


This results in the following value substitutions: 


Point of substitution Value 
in macro definition substituted 


&SYSLIST (2) TWO 

































&SYSLIST (3, 2) 4 

&SYSLIST (4) Null 
&SYSLIST (9) Null 
&SYSLIST (3, 3) Null 
&SYSLIST (3, 5) Null 
&SYSLIST (2, 1) TWO 
&SYSLIST (2, 2) Null 





&SYSLIST (3) (3, 4, , 6) 


The attributes of the previously described forms of &SYSLIST are the attributes 
inherent in the positional parameter or sublist entry referred to. 
There are two forms of &SYSLIST: | 
e To indicate the number of positional parameters in a macro call, use the form: 
N‘&SYSLIST 
e To indicate the number of sublist entries in a positional parameter, use the form: 
N‘&SYSLIST(n) 
where n indicates the positional parameter. 


For N'&SYSLIST, positional parameters are counted if specifically omitted (by 
specifying the comma that would normally have followed the omitted parameter). A 
sublist is counted as one parameter. 

For N‘&SYSLIST(n), sublist entries are counted if specifically omitted (by specifying 
the comma that would normally have followed the omitted entry). If the nth parameter is 
not a sublist, the value of N‘&SYSLIST(n) is one; if the nth parameter is omitted, the 
value of N‘'&SYSLIST(n) is zero. 

The following examples show values for N°&SYSLIST: 


MACLST 125354 











MACLST A, B,,D,E 
MACLST , A,B,C, D 
MACLST (A, B, C), (D, E, F) 


MACLST 
MACLST KEY1 = A, KEY2 = B 
MACLST A, B, KEY1 =C 


The following examples show values for NS&SYSLIST(n): 


MACSUB __ A, (1, 2, 3, 4,5), B 
MACSUB_ A, (1,, 3,, 5), B 
MACSUB_ A, (, 2, 3, 4,5), B 
MACSUB- A,B,C 

MACSUB_ A,,C 

MACSUB A, KEY = (A, B, C) 
MACSUB 













&SYSNDX—Generate Unique Symbols for Multiple Expansions 
To generate a unique suffix for a symbol used in a macro definition for each expansion of 
that macro, concatenate &SYSNDX to the symbol. Although the same symbol is 
generated by two or more expansions (two or more calling macro instructions), the suffix 
provided by &SYSNDX produces unique symbols. 

The assembler assigns &SYSNDX a read-only value each time a macro definition is 
expanded (for each calling macro instruction); this value is a 4-digit number, starting at 
0001 for the first macro call and increased by 1 for each subsequent macro call (including 
nested macro calls). 

&SYSNDX alone does not generate a valid symbol. It must be concatenated as the 
suffix to another symbol, and that symbol must not contain more than 4 characters (for a 
total of not more than 8 characters). For example, ITEM&SYSNDX. If &SYSNDX is 
concatenated to a variable symbol, the parameter assigned to that variable symbol must 
not contain more than 4 characters. For example, if the parameter THREE is substituted 
for the variable symbol &PRM&SYSNDX, the result would be THREEnnnn, which 
exceeds the length maximum for symbol names. 

The type attribute of &SYSNDX, when used as a parameter on an inner macro call, is 
always N, and the count attribute is always 4. | 
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The following example indicates the results of using &SYSNDX in naming DC and DS 
instructions. 











7 SOURCE. CODE. i i GENERATED CODE 


“CONST. et 6P2_ 


6P1 8SYSNDX oc _F'gp2! 
AREAGSYSNDX DS F_ 

~MEND 
OPEN START | 


OT Roa 10, zi 





HoH | CONST Two 0,209 Pala! a. 
on: bs F 


THREES Oc oc sie 


+ ans ree, 


ee ee” 





: Pop GE ee 3g 


eames notes, 


1. TWO0001 and TWO0002 are two different symbols, and thus are not multiply defined. 
2. THREE0003 exceeds eight characters i in length, eavaing: an error. 


g-¥ Ge Bo 


Fy 5 : : 3 ; ¢ 


&SYSPARM—System Parameter for Conditional Assembly 


The system parameter &SYSPARM allows you to control conditional assembly flow and 
source code generation through the use of a parameter specified in the assembler options 
list. Thus, you can modify the output of an assembly without changing the source code 
itself. 

The system parameter behaves like a global SETC symbol except that its value can be 
set only through the assembler options list. &SYSPARM cannot be modified during 
assembly and can only be coded inside macro definitions. 

The system parameter contains the value of a character string within quotes, which 
must be zero to 8 characters long. It may consist of any combination of EBCDIC 
characters. A single quote in the string must be represented by two quotes. If no 
&SYSPARM value is specified, the value of the system parameter is a null string. 
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USING THE CALLING MACRO INSTRUCTION 


The calling macro instruction (or macro call) provides the assembler with the name of a 
macro definition and the information or values you want passed to that macro definition. 
This information is the input to a macro definition. The assembler uses the information 
either in processing the macro definition or for substituting values into model statements 
during macro expansion. The output from a macro definition, called by a macro 
instruction, can be: 
e A sequence of source statements generated from the model statements in the macro 
definition (macro expansion) 

e Values assigned to global SET symbols, for use in other macro definitions 

You can code a macro call anywhere in the open code part of your source module. 
However, the statements generated from the called macro definition must be valid 
assembler language instructions and allowed where the calling macro instruction appears. 
A macro call is not allowed before or between your inline macro definitions, but you can 
nest them inside a macro definition. 

The format of a macro call statement is: 


macro 
name 


where the name field can contain any ordinary symbol or blank, and macro name 
identifies the macro definition to be expanded. The assembler allows up to 100 operands 
in the operand field. Your entries in the name, operation, and operand fields correspond 
to entries in the prototype statement of the called macro definition. 

If you code no operands, remarks are not allowed. You can specify remarks on a macro 
instruction with operands in any of three ways: 


1. The normal way, with all operands preceding all remarks; for example: 








zero to 100 operands, separated by commas 





~ MACNORM PARMI, PARM2 JPARYD,soasacneeecnsccnneceasensscceasseseal 
PARMN REMARKS 


2. The alternate way, allowing remarks for each operand, with continuation lines used to 
pair remarks with parameters; for example: 





-MACALT PARMI, REMARKS ABOUT PARM] =—i(a‘ié‘ésééCOX 
PARM2 , REMARKS ABOUT PARMZ = =s.—s—-—iészxK 
ARM, | REMARKS ABOUT PARM3. ai(ai‘(‘aié‘ié«SX 

PARMN REMARKS ABOUT PARMN 


3. A combination of the first two ways; for example: 


PARMA ARH, MORE REMARKS i Ne a de 
PARMN MORE REMARKS | Bagee 
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Macro Instruction Name Field 


* SOURCE 
aan 


&NAM 


NAM 


HERE 


THERE 


You are allowed any number of continuation lines. However, you must identify each 
continuation line with a nonblank character in column 72 of the previous statement line. 
Operands on continuation lines must begin in column 16 or beyond. If, in continuation 
lines, you make any entries in the columns preceding column 16, the assembler issues an 
error message and does not process the entire statement. 


The name field on a macro call can be used to generate an assembly-time label for a 
machine or assembler instruction. To accomplish this, a symbolic parameter must appear 
in the name field of the macro prototype statement and also in the name field of a model 
statement within the macro definition. Macro expansion will result in the name field of the 
model statement containing the name field entry from the calling macro instruction. For 
example: 


CODE GENERATED CODE 





MACRO 
MACNAM 


MVWS R6, (R2) 


MEND 
START 


MACNAM ie 
; HERE MVWS R6,(R2) 
THERE MVWS R6,(R2) ts 





Macro Instruction Operation Field 


The symbolic operation code identifies the macro definition that you want the assembler 
to process. The operation entry for a macro instruction must be a valid symbol that is 
identical to the operation code in the prototype statement of the macro definition you 
want to call. 


Note. If one of your inline macro definitions has the same name as a source file macro 
definition, the assembler processes the inline macro definition. 


Macro Instruction Operand Field 
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You use the operand entry in a macro instruction to pass values (parameters) to the called 
macro definition. These values can be passed through: 


e The symbolic parameters you have specified in the macro prototype, or 


e The system variable symbol &SYSLIST, if it is specified in the body of the macro 
definition. 


Macro Instruction Operands 


Positional Parameters on the Macro 


The assembler allows two types of parameters in a macro instruction operand; positional 
and keyword. You can specify a sublist with multiple values in both types of parameters. 
“Symbolic Parameters” earlier in this chapter explains the advantages of each type. 
Special rules for the various values passed in parameters are given in “Values in Macro 
Instruction Parameters” in this chapter. 


Instruction 

Use a positional parameter on the macro call to pass a value to a macro definition through 
the corresponding positional parameter declared on the prototype statement or to pass a 
value to the system variable symbol &SYSLIST. 

If you specify &SYSLIST with appropriate subscripts in a macro definition, you do not 
need to declare positional parameters in the prototype statement. You can thus use 
&SYSLIST to refer to any positional parameter. And, &SYSLIST allows you to vary the 
number of parameters passed with each calling macro instruction. 

If &SYSLIST is not used, you must code the positional parameters on the calling macro 
instruction in the same order and quantity as the positional parameters declared in the 
macro definition prototype statement. Otherwise: 


e If the number of positional parameters on the calling macro instruction is greater than 
the number of positional parameters on the macro definition prototype statement, the 
excess parameters are meaningless. 

e If the number of positional parameters on the calling macro instruction is less than the 
number of positional parameters on the macro definition prototype statement, the 
omitted parameters pass null character string values to corresponding parameters. 

You must ensure that the nth parameter on the calling macro instruction and the nth 
parameter on the macro definition prototype statement are appropriately paired; omitted 
parameters on the calling macro instruction must be indicated specifically by coding the 
comma that would normally follow the omitted parameter, to maintain proper 
correspondence of subsequent parameters. For example: 


* INSTRUCTIONS DESCRIPTION 


* 
MACRO 
OMIT &P1,&P2,6P3 PROTOTYPE STATEMENT 
DC  &P1EP2'ALWAYS &P3' MODEL STATEMENT USING 
SYMBOLIC PARAMETERS 
MEND 
START 
OMIT ,C,HERE CALLING MACRO INSTRUCTION THAT = 
: GENERATES THE FOLLOWING INSTRUCTION: 
a er DC C'ALWAYS HERE* 
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Keyword Parameters on the Macro Instruction 
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* 


SHOW 


OPEN 


Use a keyword parameter on the macro call to pass a value through a keyword davuneter 
into a macro definition. To override the default value assigned to a keyword parameter on 
the prototype statement, code the corresponding keyword parameter on the macro 
instruction. 

Any keyword parameter you specify in a macro instruction must correspond to a 
keyword parameter in the prototype statement. However, you do not have to code 
keyword parameters in any particular order. 

You must code a keyword operand in the format keyword=value. The keyword coded 
on the calling macro instruction has up to seven characters and is not preceded by an 
ampersand; the corresponding keyword on the macro prototype statement consists of the 
same characters preceded by an ampersand. The value coded on the calling macro 
instruction can be up to 127 characters long. The value you specify overrides the default 
value in the prototype statement. The default value has the same rules as a value in a 
keyword parameter. 

The following examples describe (1) the relationship between keyword operands and 
keyword parameters, and (2) the values that the assembler assigns to these parameters 
under different conditions. 


* INSTRUCTIONS DESCRIPTION 


MACRO 
MAC ‘SKEYI=DEFAULT, &KEY2= PROTOTYPE STATEMENT~~DEFAULT VALUE 


DC 


FOR &KEY2 1S A NULL CHARACTER STRING 
C'SKEYIEKEY2' 


MEND 
START 


os ee =" ee ee a oo ee a ee ce 


MAC KEYI=OVERRIDE,KEY2=1 CALLING MACRO INSTRUCTION THAT 


GENERATES: 
SHOW DC C'OVERRIDE!' 


C KEYI=OVERRIDE CALLING MACRO INSTRUCTION THAT 


GENERATES: 
SHOW DC C'OVERRIDE' 


C KEY2=1 CALLING MACRO INSTRUCTION THAT 


GENERATES: 
SHOW DC C'DEFAULTI' 


C CALLING MACRO INSTRUCTION THAT 


GENERATES: 
SHOW DC C'DEFAULT' 


END 


The assembler issues an error message when the keyword of the calling macro 
instruction does not correspond to any keyword on the prototype statement. 

You can specify the null character string as the value for a keyword parameter either as 
a default value on the prototype statement or on the calling macro instruction by coding 
&keyword= or Keyword=, respectively, with no value following the equal sign. If another 
keyword parameter follows, the equal sign would be followed by a comma with no 
intervening blanks. 


Combining Positional and Keyword Parameters 


* 


. 


You can use a combination of positional and keyword parameters in the same macro 


instruction. For example: 


INSTRUCTIONS 


MACRO 
MIXED 


MEND 
START 


MIXED 


MIXED 


MIXED 
MIXED 


END 


18, YES 


P3=19,Ph4=YES 


18 ,P4=YES 


DESCRIPTION 


&P1 ,&P2,&P3=16, sP4=N0 


CALLING MACRO INSTRUCTION THAT 
USES POSITIONAL PARAMETERS 


CALLING MACRO INSTRUCTION THAT 
USES KEYWORD PARAMETERS 


CALLING MACRO INSTRUCTION THAT 
USES BOTH POSITIONAL AND 
KEYWORD PARAMETERS 


CALLING MACRO INSTRUCTION WITH NO 
PARAMETERS=-USING DEFAULT VALUES 


All positional parameters on the calling macro instruction must precede all keyword 
parameters on that instruction. The list of positional parameters must correspond to the 
positional parameters on the macro definition prototype statement as described under 
‘Positional Parameters on the Macro Instruction.” 
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You can use a sublist in a positional or keyword parameter on the calling macro 
instruction to specify several values. A sublist is one or more entries separated by commas 
and enclosed in parentheses. The sublist, including parentheses, must not exceed 127 
characters. 

In a macro definition, you can refer to the value of each entry by coding: 


e The corresponding symbolic parameter with an appropriate subscript, or 
e The system variable symbol &SYSLIST with appropriate subscripts, the first to refer 
to the positional parameter and the second to refer to the sublist entry in the operand. 
These rules apply to sublists in macro instructions: 


e &SYSLIST can refer only to sublists in positional parameters. 

e The value in a positional or keyword parameter can be a sublist. 

e A symbolic parameter as used within the macro definition can refer to the entire 
sublist or to an individual entry of the sublist. To refer to an individual entry, the 
symbolic parameter must have a subscript whose value indicates the position of the 
entry in the sublist. The subscript must have a value greater than or equal to one. 


* INSTRUCTIONS 


* 


KEY 


&P1(1) 


MACRO 
MAC 


© es e 


C 


C 


ee ef c@ CJ ee co ve 


MEND 
START 


MAC 


ee #0 6¢8 28 


END 


&P1,6P2,&KEY=(F ,@) 


&KEY (1) 'SKEY (2) ' 


&P1(2)'sP1 (3)! 


A&P2 


(POS ,F,208) , (A,B,C) 


DESCRIPTION 


PROTOTYPE STATEMENT WITH SUBLIST 
DEFAULT VALUE FOR KEYWORD PARAMETER 


MODEL STATEMENT=-SUBSCRIPTS REFER TO 
POSITIONS WITHIN SUBLIST VALUE FOR _ 
&KEY hoae 


MODEL STATEMENT==SUBSCRIPTS REFER TO 
POSITIONS WITHIN SUBLIST VALUE TO BE 


PASSED AS POSITIONAL PARAMETER ON | 
MACRO CALL 


MACRO CALL THAT GENERATES: 
KEY DC F'@! 


POS 0C F'2¢9' 


Dc A(A,B,C} 


The following table shows the relationship between subscripted parameters and sublist 
entries when: 


A sublist entry is omitted. 

The subscript refers past the end of the sublist. 
The value of the operand is not a sublist. 

The parameter is not subscripted. 


Parameter in macro Sublist in Value generated 


definition 


&PAR (3) 
&PAR (5) 


macro call 


Null character string 
— character string 


&PAR 
&PAR (1) 
&PAR (2) 
&PAR 


Nall character string 


<a or a 
— 
(A) 
see Note 1 below. 
Null character ting 
ne Note 1 below. 


&PAR (1) 

&PAR (2) 

&PAR 
Ss Note 2 below. 


&PAR (1) 
a Note 2 below. 


See Note 2 below. 
See Note 3 below. 
Nothing 

See Note 4 below. 


Note 1. Because the single value A is enclosed in parentheses, it is considered a sublist 
with one entry. 


&PAR (3) 
&PAR (2) 


&PAR (1) 


Note 2. The value of the operand is not a sublist. It is considered to be a character 
string. 

Note 3. The blank between commas on the calling macro instruction indicates end of 
the operand field; thus instead of a null character string value being passed to the macro 
definition, no value is passed. In addition, an error message is generated because the 
assembler considers this an unmatched left parenthesis. 


Note 4. The blank following the left parenthesis indicates end of the operand field; thus 
instead of a null character string value being passed to the macro definition, no value is 
passed. In addition, an error message is generated because the assembler considers this an 
unmatched left parenthesis. 





The macro definition can also use &SYSLIST to refer to sublist entries in positional 
parameters. For example, given the sublist 


A,(1,2,3,4) 
&SYSLIST(2,3) would have the value 3. 
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&A+&B+3+ &C* 10 &A=2- 2+X+3+COUNT* 10 
&B=X 
&C = COUNT 


You can use a macro instruction parameter to pass values to a macro definition. The two 

types of values you can pass are: 

e Explicit values, or the actual character strings you specify in the operand of the calling 
macro instruction 

@ Implicit values, or the attributes inherent to the data represented by the explicit values 


The explicit value of a macro instruction parameter is a character string that must not 
exceed a length of 127 characters (including any sublists). If the macro call is contained 
within a macro definition (a nested macro call), the explicit value of the parameter may 
contain: 

e Variable symbols 

e Any of the symbolic parameters specified in the prototype statement of the containing 
macro definition 

e Any SET symbols declared in the containing macro definition 

e The system variable symbols 

If the macro call is in open code, it cannot contain the above symbols. 

The assembler assigns the character string value, including sublist entries, to the 
corresponding parameter declared in the prototype statement. A sublist entry is assigned 
to the corresponding subscripted parameter. When you omit a keyword parameter on the 
calling macro instruction, the assembler assigns the default value specified for the 
corresponding keyword parameter on the prototype: statement. When you omit a 
positional parameter or sublist entry, on the calling macro instruction, the assembler 
assigns the null character string to the parameter. Any of the 256 characters of the 
EBCDIC character set can appear in a macro instruction parameter (or sublist entry). 
However, the following characters require special consideration: 


Ampersands. In macro calls nested within macro definitions a single ampersand indicates 
the presence of a variable symbol. The assembler substitutes the value of the variable 
symbol into the character string specified in a macro instruction parameter. The resultant 
String is then the value passed into the macro definition. If the variable symbol is 
undefined, the assembler issues an error message. You must specify double ampersands if 
they are to be passed without substitution to the macro definition. 

















Value specified on Value of variable Character string 
macro call symbols values passed 











‘&®MESSAGE’ ‘BLANK BETWEEN’ 
(see Quoted Strings in 


this list.) 


BLANK BETWEEN 
&&REGISTER | &&REGISTER 


Apostrophes. A single apostrophe indicates the beginning and end of a quoted string. 











Quoted Strings. A quoted string is any sequence of characters that begins and ends with a 
single apostrophe (compare with conditional assembly character expressions). You must 
specify double apostrophes inside each quoted string to result in a single apostrophe 
value. This includes substituted apostrophes. Macro instruction parameters can have 
values that include one or more quoted strings. Each quoted string can be separated from 
the following quoted string by one or more characters, and each must contain an even 
number of apostrophes. Quoted strings can contain variable symbols only on macro calls 
nested within macro definitions. The following examples indicate the values passed for 
quoted strings: 


Value on macro call Value of variable Value passed 
symbol 


‘&& NOTATION’ Fs NOTATION’ 
| &MESSAGE=OK 


‘&MESSAGE’ &MESSAGE = OK | ‘OK 
De ee ee ee ee ee el 

‘ZQUOTES’ RQUOTES="*> ©? Repel sae 
‘QUOTE’ AND ‘QUOTE2” 


‘QUOTEI’ AND ‘QUOTE2” 
‘QUOTEI’ ‘QUOTE2’ 











eer 
ea 


Parentheses. In macro instruction operand values, there must be an equal number of left 
and right parentheses. They must be paired; that is, to each left parenthesis belongs a 
following right parenthesis at the same level of nesting. An unpaired (single) left or right 
parenthesis can appear only in a quoted string. 


Blanks. One or more blanks outside a quoted string indicates the end of the entire 
operand field in a macro instruction. Thus, blanks should be used only inside quoted 
strings. 


Commas. A comma outside a quoted string indicates the end of a parameter value or 
sublist entry. Commas that do not delimit values can appear inside quoted strings or 
inside paired parentheses that do not enclose sublists. A comma must not follow the final 
parameter specification. 


Equal Signs. An equal sign can appear in the value of a macro instruction parameter 
sublist entry (1) inside quoted strings, or (2) between paired parentheses. For example: 


MACCALL A'='B,C(A=B) 





Where ‘=’ is a quoted string and C(A=B) is a character string. 
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OPEN 


Periods. A period can appear in the value of a parameter or sublist entry. It will be passed 
as a period. However, if you use a period immediately after a variable symbol (valid only 
on macro calls from within macro definitions), it becomes a concatenation character. In 
this case, you must code two periods if one is to be passed as a character. 


Character string on Value of variable Value passed 
macro call symbol 


3.4 3.4 

(3.4, 3.5, 3.6) (3.4, 3.5, 3.6) 
&A.1 FIELD1 
&A.1 31 

&A..1 3.1 


&AK&B &A = AREA AREA200 
&B = 200 

&A.&B &A = AREA AREA200 
&B = 200 


&DISP. (& BASE) &DISP = 1000 1000 (10) 
&BASE = 10 





A nested macro instruction is a macro instruction specified as one of the statements in 
the body of a macro definition. The assembler allows the expansion of a macro definition 
from within another macro definition. Any macro instruction in the open code of a 
source module is an outer macro call, Any macro instruction that appears within a macro 
definition is an inner macro call. For example: 


MACRO 
OUTER PROTOTYPE STATEMENT 


INNER INNER MACRO CALL 
MEND 

MACRO 

INNER PROTOTYPE STATEMENT 


MEND 
START 


OUTER OUTER MACRO CALL 


END 


The code generated by a macro definition called by an inner macro call is nested inside 
the code generated by the macro definition that contains the inner macro call. In the 
macro definition called by an inner macro call, you can include a macro call to another 
macro definition. Thus, you can nest macro calls at different levels. 

The zero level includes outer macro calls that appear in open code; the first level of 
nesting includes inner macro calls that appear inside macro definitions called from the 
zero level; the second level of nesting includes inner macro calls inside macro definitions 
that are called from the first level, etc. 


You can also call a macro definition recursively—the body of a macro definition can 
contain an inner macro call to that same macro definition. In other words, a macro can 
call itself. This allows you to define macros to process recursive functions. 

When macro instructions appear inside macro definitions, the assembler substitutes 
values in the same way as it does for the model statements in the containing macro 
definition. The assembler processes the called macro definition, passing to it the operand 
values (after substitution) from the inner macro instruction. 

The number of nesting levels permitted depends on the complexity and size of the 
macros at the different levels: the number of operands you specify, the number of local 
and global SET symbols you declare, and the number of sequence symbols you use. 

Exits taken from the different levels of nesting when a MEXIT or MEND instruction is 
encountered are as follows: 

e From the expansion of a macro definition called by an inner macro call, the exit is to 
the next sequential instruction after the inner macro call. 

e From the expansion of a macro definition called by an outer macro, the exit is to the 
next sequential instruction after the outer macro call in your open code. 

You can pass a parameter value in an outer macro instruction through one or more 
levels of nesting. However, the value you specify in the inner macro instructions must be 
identical to the corresponding symbolic parameter declared in the prototype statement. 
Thus, you can pass and refer to a sublist in the macro definition called by the inner macro 
call. Also, all symbols carry their inherent attribute values through the nesting levels. You 
can pass values from open code through several levels of macro nesting if you specify 
inner macro calls at each level with symbolic parameters as parameter values. For 
example: 


* INSTRUCTIONS DESCRIPTION 
MACRO | = ee een tee 
OUTER sP PROTOTYPE STATEMENT FOR OUTER 
INNER. sP NESTED MACRO CALL 
— MEND 
MACRO. | 7 Fed 
INNER &Q | PROTOTYPE STATEMENT FOR INNER. 


— MWsgQ(1), RI 


MVW ORI, 6Q(3) 
END 
START 9 | START OF OPEN CODE 


| TER (anéa, AoE 2H, SUM) MACRO CALL IN OPEN CODE. PRODUCES THE. 


: FOLLOWING NESTED MACRO CALL: 
3 INNER (AREA,F29@, SUM) 

2 WHICH PRODUCES THE. FOLLOWING: 
3 MVW AREA,RI 

- AW F298,RI 

3 MVW RI,SUM 

END 
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* INSTRUCTIONS DESCRIPTION 

| MACRO | : 
OUTER &P,&Q PROTOTYPE STATEMENT FOR OUTER 
INNER (ABC,&P,DEF) ,6Q+3 NESTED MACRO CALL 
MEND cost cce 
INNER &R,6&S PROTOTYPE STATEMENT FOR INNER 
DC  AS&R(2) 
DS XL (&S) 

 MEND _ | 

START g START OF OPEN CODE 


OUTER (ADX ,ADY , ADZ) _ 


Note. If a symbolic parameter is only a part of the value in an inner macro instruction, 
only the character string value given to the parameter by an outer call passes through the 
nesting level. Inner sublist entries and attributes of symbols are not available for reference 
in the inner macro. 








ki INNER (ABC, (ADX,ADY 02) a 
3 WHICH RESULTS IN: | 

DC A(ADX,ADY ,ADZ) 

DS XL (TWO y 

END 


The assembler gives system variable symbols local read-only values that depend on the 
position of your macro call and the parameter value specified on the macro call. 


&SYSLIST. If you specify &SYSLIST in a macro definition called by an inner macro 
instruction, then &SYSLIST refers to the positional operands of the inner macro 
instruction. 


&SYSNDX. The assembler increases the value of &SYSNDX by one each time it 
encounters a macro call. It retains the increased value throughout the expansion of the 
macro definition that is called; that is, within the local scope of the nesting level. For 
example, if open code contains a macro call to the macro INNER1, and INNER1 contains 
a call to the macro INNER2, and the value of &SYSNDX is 0001 when the call to INNER 
1 is executed, then &SYSNDX will have the value 0002 throughout the expansion of 
INNER1 except for the portion of code included from INNER2 at the point of the call 
from INNERI to INNER2 (for that portion &SYSNDX will have the value 0003); note 
that the value of &SYSNDX is 0002 for all code expanded from INNERI after the 
portion inserted from INNER2. 


&SYSPARM. The nesting of macros does not affect &SYSPARM. 


CONDITIONAL ASSEMBLY LANGUAGE 


SET Symbols 


This section describes the conditional assembly language used to interact with symbolic 
parameters and system variable symbols inside a macro definition. With the conditional 
assembly language, you can perform general arithmetic and logical computations as well 
as many of the other functions you can perform with any other programming language. 
By combining conditional assembly instructions with assembler and machine instructions, 
you can: 


e Select sequences of model statements, from which the assembler generates machine 
and assembler instructions 
e Vary the contents of these model statements during generation 


The assembler processes the instructions and expressions of the conditional assembly 
language at preassembly time. Then, at assembly time, it processes the generated model 
statements. Conditional assembly instructions, however, are not processed after 
preassembly time. 

The elements of the conditional assembly language are: 

e SET symbols that represent data 
e Attributes that represent different characteristics of data 
e Sequence symbols that act as labels for branching to statements at preassembly time 


The functions of the conditional assembly language are: 


e Declaring SET symbols as variables for use by the conditional assembly language in its 
computations 

e Assigning values to the declared SET symbols 

e Evaluating conditional assembly expressions used as values for substitution, as 
subscripts for variable symbols, or as condition tests for branch instructions 

e Selecting characters from strings, for substitution in and concatenation with other 
strings, or for inspection in condition tests 

e Branching and exiting from conditional assembly loops 


SET symbols are variable symbols that provide arithmetic, binary, or character data, 
whose values you can vary at preassembly time. 
You can use SET symbols as: 


Terms in conditional assembly expressions 
Counters, switches, and character strings 
Subscripts for variable symbols 

Values for substitution 


Thus, SET symbols allow you to control your conditional assembly logic and to 
generate many different statements from the same model statements. 

You can use a SET symbol to represent an array of many values. You can then refer to 
any one of the values in this array by subscripting the SET symbol. 

You must declare a SET symbol before you can use it. If you declare a SET symbol to 
have a local scope, you can use it only in the statements that are part of the same macro 
definition. If you declare a SET symbol to have a global scope, you can use it in 
statements that are part of: 

e The same macro definition 
e Any other macro definition 

You must, however, declare the SET symbol as global in each macro definition where 

you use it. You can change the value you previously assigned to a SET symbol without 
affecting the scope of the symbol. 
Note. A symbolic parameter has a local scope. You can use it only in the statements that 
are part of the macro definition where you declare the parameter in the prototype 
statement. The values of &SYSNDX and &SYSLIST are local to each individual macro 
definition. The value of &SYSPARM is global—the same within all macro definitions. 
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Three types of SET symbols are used in model statements and conditional assembly 
instructions: 
e SETA (arithmetic data) 
e SETB (binary data) 
e SETC (character data) 

You must declare a SET symbol, to determine its scope and type, before you can use it. 
The declaration instructions for SET symbols are: 


SET symbol type Scope of SET symbol 


LCLA &symbol Local 
LCLB &symbol Local 


LCLC &symbol Local 

GBLA &symbol Global 
GBLB &symbol Global 
GBLC &symbol Global 





where &symbol indicates the name of the SET symbol declared. 


Once a SET symbol has been declared, you can change the value of that symbol with 
the SETA, SETB or SETC instruction anywhere within the declared scope of the SET 
symbol. Values of symbolic parameters and system variable symbols, in contrast, remain 
fixed throughout their scope. Wherever a SET symbol appears in a statement, the 
assembler replaces the symbol with the last value assigned to the symbol. 

The features of SET symbols are compared with those of symbolic parameters and 


system variable symbols in the following table. 
SET symbols Symbolic parameters System variable symbols 
yes 


yes yes 
no—&SYSNDX, &SYSLIST 
yes—-&SYSPARM 


no 




















Local scope 






Global scope yes no 








Values can 
change within 
scope 


Note. You can use SET symbols in the name and operand fields of inner macro calls; 
however, the assembler considers the value thus passed through a symbolic parameter into 
a macro definition to be a character string and generates it as such. 


A subscripted SET symbol is written as: 

&symbol(subscript) 

where &symbol is a valid SET symbol name and the subscript is an arithmetic expression 
with a value greater than zero. You can use a subscripted SET symbol anywhere an 
unsubscripted SET symbol is allowed. However, you must declare subscripted SET 
symbols as dimensioned in a previous local or global declaration instruction. The 
subscript refers to one of the many positions in an array of values identified by the SET 
symbol. The value of the subscript must not exceed the dimension declared for the array 
in the corresponding local or global declaration instruction. For example: 


LCLA sARRAY (28) DECLARE ARRAY oF 26 ELEMENTS 





GARRAY(5) SETA 5 REFER TO FIFTH ELEMENT 


Note. A subscript can be a subscripted SET symbol. Five levels of subscript nesting aré 
allowed. 
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Data Attributes 


Macro instruction operands can be described in terms of: 

e Type, which distinguishes numeric data and identifies missing operands. 

e Count, which gives the number of characters required to represent data in a macro 
instruction operand. 

e Number, which gives the number of operands in a macro instruction or the number of 
sublist entries in an operand. 

These three characteristics are called data attributes. The assembler assigns attribute 
values to the symbolic parameters and &SYSLIST that represent the operands. 

Specifying attributes in conditional assembly instructions allows you to control 
conditional assembly logic, which in turn can control the sequence and contents of the 
statements generated from model statements. The specific purpose for which you use an 
attribute depends on the kind of attribute being considered. The attributes and their main 
uses are listed in the following table. 


Gives a letter that identifies —In tests to distinguish numeric 
type of data represented data 
—To discover missing operands 


Gives the number of —For scanning and decomposing 


characters required to of character strings 
represent data —As indexes in sub-string notation 


Gives the number of —For scanning sublists 

sublist entries in operand —As counter to test for end of 
sublist or number of sublist 

operands in a macro 

instruction 





The format for an attribute reference is: 
code‘symbol 
where code is one of the three attribute codes (T for type, K for count, or N for number) 
and symbol is a variable symbol; the apostrophe between code and symbol must be 
present. 

The attribute notation indicates the attribute whose value you desire. The variable 
symbol represents the data that has the attribute. The assembler substitues the value of 
the attribute for the attribute reference. The attribute reference can appear only in 
conditional assembly instructions. Thus, their values are available only at preassembly 
time. 

Note. You can use the system variable symbol &SYSLIST in an attribute reference to 
refer to a macro instruction operand. 
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Type Attribute (T) 


Count Attribute (K) 


Number Attribute (N) 
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O 
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The type attribute has a value of a single alphabetic character that indicates the type of 
data represented by a macro instruction operand. If the operand is a sublist, the entire 
sublist and each entry in the sublist can possess the type attribute. 


Type attribute codes Data characterized by type attribute code 








A self-defining term used as macro instruction operand 





Omitted macro instruction operand (has a value of a null 
character string) 







Non-numeric macro instruction operand 





You can use a type attribute reference only in the SETC instruction or as one of the 
comparison values in a SETB or AIF instruction. 


The count attribute applies only to macro instruction operands. It has a numeric value 
equal to the total number of characters in a macro instruction operand. You can use a 
count attribute reference only in arithmetic expressions. The count attribute for an 
omitted operand is zero. For example: 


Macro instruction operands Value of count attribute 


ALPHA 

(SUB, LIST, ALL) 
2 (10, 12) 

‘A’ ‘BR’ 

‘? blank 

= null character string 
(omitted operand) 











The number attribute applies only to the operands of macro instructions. It has a numeric 
value that is equal to the number of sublist entries in an operand (1 + the number of 
commas separating the entries). 

You can use a number attribute reference only in arithmetic expressions. N°&SYSLIST 
refers to the total number of positional parameters in a macro instruction, and 
N‘&SYSLIST(m) refers to the number of sublist entries in the mth parameter. If the mth 
parameter is not a sublist, the value of NS&SYSLIST(m) is.1. For example: 


Macro instruction operand sublist Value of number attribute 


(A, B, C, D) 
(A, , B, C, D, E) 
(, B, C, D) 

(A) 

A 


(No operands) 





‘Sequence Symbols 


You can use a sequence symbol in the name field of a statement to branch to that 
statement at preassembly time, thus altering the sequence in which the assembler 
processes your conditional assembly and macro instructions. You can select the model 
statements from which the assembler generates assembler language statements. 

A sequence symbol is written as a period followed by an alphabetic character, followed 
by 0—6 alphameric characters (for a total of 2—8 characters). For example: 


SEQ 
.A1234 
#924 


You can specify sequence symbols in the name field of any model statements in a 
macro definition, except instructions that already contain ordinary or variable symbols in 
the name field. You cannot specify a sequence symbol in the name field of the macro 
prototype statement. 

You can specify sequence symbols in the operand field of an AIF or AGO instruction 
to branch to a statement with the same sequence symbol in its name field. Sequence 
symbols have a local scope. Thus, if you code a sequence symbol in an AIF or AGO 
instruction, you must define that sequence symbol as a label in the same macro 
definition. And, since the scope for sequence symbols is local, you can use the same 
sequence symbol in several macro definitions, without conflict. For example: 





MACRO 
 MACONE 


AGO _.GENERAT 


HEN 









Note. The assembler does not substitute a sequence symbol from the name field of an 
inner macro call for the parameter in the name field of the corresponding prototype 
statement. 
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Declaring SET Symbols 


You must declare a SET symbol before you can use it. In the declaration, you specify 
whether it is to have a global or local scope. The assembler assigns an initial value to a 
SET symbol at its point of declaration. All global declarations must immediately follow 
the macro prototype statement; local declarations must immediately follow any global 
declarations. 


LCLA, LCLB, and LCLC Instructions 


The LCLA, LCLB, and LCLC instructions declare local SETA, SETB, and SETC symbols. 
The format of the LCLA, LCLB, and LCLC instructions is: 


LCLA 
blank LCLB one or more variable symbols to be used as SET symbols, 
LCLC separated by commas 


The name field of the LCLA, LCLB, and LCLC instructions must be blank. These 
instructions must appear immediately following any GBLA, GBLB, or GBLC instructions. 
Any variable symbols declared in the operand field have a local scope. You can use them 
as SET symbols anywhere after the pertinent LCLA, LCLB, or LCLC instructions, but 
only within the declared local scope. The following example indicates the scope of several 
local SET symbols: 









apiece Sp ROOM Po oo nag he 


 nacRO sis, a 
“UCLA GAL score oF SAL STARTS HERE 









peed HIME 6Cl SCOPE OF SCI STARTS HERE 
END SCOPE OF GA AND 6C1 ENDS WERE 


MUSiLE - ERpeOEePeaneene ELEVELIETS rear caenniueles 
LLL OWA BAZ Cs SCOPE. oF. 6A2 STARTS HERE 
LCL 602 SCOPE OF &C2 STARTS HERE 


SCOPE OF 6 5A2 AND sez. END HERE 








The assembler assigns initial values to local SET symbols as follows: 


Initial value assigned to SET symbols 













LCLA 0 
LCLB 0 
LCLC Null character string 
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A local SET variable symbol declared by the LCLA, LCLB, or LCLC instruction must 
not be identical to any other variable symbol within the same local scope. The following 
rules apply to a local SET variable symbol: 

e It must not be the same as any symbolic parameter declared in the prototype 
statement. 

e It must not be the same as any global variable symbol declared within the same local 
scope. 

e The same variable symbol must not be declared or used as 2 different types of SET 
symbols, for example, as a SETA and a SETB symbol, within the same local scope. 

Note. A local SET symbol should not begin with the characters &SYS; this prefix is 

reserved for system variable symbols. 

You declare a subscripted local SET symbol with the LCLA, LCLB, or LCLC 
instruction by following the subject name with dimension information enclosed in 
parentheses. For example: 


LCLA 6ARRAY (1) 


The dimension must be an unsigned decimal self-defining term not equal to zero. The 
maximum dimension allowed is 255. The dimension indicates the number of SET 
variables associated with the subscripted SET symbol. The assembler assigns an initial 
value to every variable in the array (the same initial value as for nonsubscripted local SET 
symbols). You can use a subscripted local SET symbol only if the declaration has a 
subscript, which represents a dimension. You can use a nonsubscripted local SET symbol 
only if the declaration has no subscript. 


GBLA, GBLB, and GBLC Instructions 
GBLA, GBLB, and GBLC instructions declare global SETA, SETB, and SETC symbols. 
The format of the GBLA, GBLB, and GBLC instruction statements is: 


GBLA 
blank GBLB one or more variable symbols to be used as SET symbols, 
GBLC separated by commas 


The name field of the GBLA, GBLB, and GBLC instructions must be blank. 

The GBLA, GBLB, and GBLC instructions must appear immediately following the 
macro prototype statement. Any variable symbols declared in the operand fields of these 
instructions have a global scope. You can use them as SET symbols anywhere after the 
pertinent GBLA, GBLB, or GBLC instructions; note that they can be used only in those 
macro definitions which contain the global declarations. Global scope means the value 
can be passed from one macro definition to another, as opposed to local scope which 
means the value is initialized for each macro definition. 
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For example, in the following code, values can pass between the macro definitions 
MAC1 and MAC2 through the global SET symbols &B and &C; the value of &A in MAC1 
is unknown to MAC2, and the value of &A in MAC2 is unknown to MACI since &A is a 
local SET symbol. 


MACRO 
MAC | 
GBLB 6B 
GBLC 6&C 
LCLA 6&A 


MEND 
MACRO 


~MAC2 


GBLB &B 


—GBLC &C 


LCLA 6&A 


MEND 
START 


MAC) 


MAC2 


END 


The assembler assigns an initial value to a global SET symbol when processing the first 
GBLA, GBLB, or GBLC instruction containing the symbol (in the first macro definition 
which declares the symbol to be a global SET symbol); initial values are not reassigned 
when the global SET symbol is subsequently declared in other macro definitions. The 
initial values assigned to global SET symbols are: 


Initial value assigned to SET symbols 

















GBLA 0 
GBLB 0 
GBLC Null character string 


OPEN 


The following example shows the values of a global SET symbol: 


MACRO 
GBLA 5A SA INITIALIZED TOP 


MEND 

MACRO 

SECOND 

GBLA A 

MEND 

START 

FIRST SA=f | , 
SECOND GA=VALUE DETERMINED BY FIRST 
FIRST SAmVALUE DETERMINED BY SECOND 
END 


A global SET symbol declared by the GBLA, GBLB, or GBLC instruction must not be 
identical to any other variable symbol used within the same macro definition. The 
following rules apply to a global SET symbol: 

e It must not be the same as any symbolic parameter declared in the prototype 
Statement. 

e It must not be the same as any local variable symbol declared within the same macro 
definition. 

e The same variable symbol must not be declared or used as 2 different types of global 
SET symbol, for example, as SETA and SETB symbols. 


Note. A global SET symbol should not begin with the characters &SYS; this prefix is 
reserved for system variable symbols. | 


You declare a subscripted global SET symbol with the GBLA, GBLB, or GBLC 
instruction by following the symbol name with dimension information enclosed in 
parentheses. For example: 


GBLA  sARRAY(1) 


The dimension must be an unsigned decimal self-defining term not equal to zero. The 
maximum dimension allowed is 255. The dimension indicates the number of SET 
variables associated with the subscripted SET symbol. The assembler assigns an initial 
value to every variable in the array (the same initial value as for nonsubscripted global 
SET symbols). You can use a subscripted global SET symbol only if the declaration has a 
subscript, which represents a dimension. You can use a nonsubscripted global SET 
symbol only if the declaration has no subscript. Wherever you declare a particular global 
SET symbol with a dimension as a subscript, the dimension must be the same in each 
declaration. 
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Assigning Values to Set Symbols 


SETA--Assign Arithmetic Value 


SETA assigns an arithmetic value to a SETA symbol. You can specify a single value or an 
arithmetic expression; the assembler will compute the value of the expression. Since you 
can change the value of a SETA symbol by assigning arithmetic expressions, you can use 
SETA symbols as counters, indexes, or for other repeated computations that require 
varying values. 

The format of the SETA instruction is: 


symbol SETA 








arithmetic expression 








The symbol in the name field must have been previously declared as a SETA symbol in 
a GBLA or LCLA instruction. The assembler evaluates the arithmetic expression in the 
operand field as a signed 32-bit arithmetic value and assigns this value to the SETA ~ 
symbol in the name field. The SETA symbol in the name field can be subscripted, but 
only if the same SETA symbol is declared with an allowable dimension. If the symbol in 
the name field is subscripted, the assembler assigns the value of the expression in the 
operand field to the position in the declared array given by the value of the subscript. The 
subscript expression must not (1) be zero, (2) have a negative value, or (3) exceed the 
dimension you specified in the declaration. 


: INSTRUCT I ONS DESCRIPTION 
| LcLA &A _ 
UCLA &SUBA(99) DECLARE 9f~ELEMENT ARRAY 
esunacep) “SETA 2099 SET 20TH ELEMENT=2009 
6A : “SETA &SUBA (29) SET SA=20TH ELEMENT (2608) 
ssimentas SETA 196g *KERROR** ONLY 99 ELEMENTS 


SETC— Assign Character Value 
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SETC assigns a character string value to a SETC symbol. You can assign whole character 
Strings or concatenate several smaller strings. The assembler assigns the composite string 
to your SETC symbol. A maximum of 8 characters is allowed in the composite character 
string. You can also assign parts of a character string to a SETC symbol by using substring 
notation. 

You can change the character value assigned to a SETC symbol. This allows you to use 
the same SETC symbol with different values for character comparisons in several places 
or for substituting different values into the same model statement. 

The format of the SETC instruction is: 





one of 4 options 





The variable symbol in the name field must have been previously declared as a SETC 
symbol in GBLC or LCLC instruction. The four options you can specify in the operand 
field are: 


e A type attribute reference 

e A character expression 

e A substring notation 

e A concatenation of substring notations, character expressions or both 


The assembler assigns the first 8 characters of the character string in the operand field 
to the SETC symbol in the name field. 


Note. When you code a SETA or SETB symbol in a character expression, the unsigned 
decimal value of the symbol (with leading zeros removed) is the character value given to 
the symbol. 


Value of Value of 
SETC Instruction variable symbol SET symbol 


&C1 SETC T'&DATA &DATA-RST 
&C2 SETC ‘ABC’ 

&C3 SETC ‘ABCDE’ (1,3) 
&C4 SETC ‘ABC’. ‘DEF’ 
&C5S SETC ‘&A’ 
&C6 SETC ‘&A’ 
&C7 SETC ‘&A’ 
&C8 SETC ‘200’ 
&C9 SETC ‘&A’ 
&C10 SETC ‘00200’ 
&C11 SETC ‘&A+11’ 
&C12 SETC ‘1 — &A’ 


















The SETC symbol in the name field can be subscripted, but only if the same SETC 
symbol has been previously declared in a GBLC or LCLC instruction with an allowable 
dimension. If the symbol in the name field is subscripted, the assembler assigns the 
character value represented by the operand field to the position in the declared array 
given by the value of the subscript. The subscript expression must not (1) be zero, (2) 


have a negative value, or (3) exceed the dimension you specified in the declaration. 


* INSTRUCTIONS 
* 


LCLC &C 
LCLC sSUBC(2¢) 


&SUBC(18) SETC 'ABC' 
&C SETC sSUBC(1P) 


&SUBC(25) SETC 'DEF' 


DESCRIPTION 


DECLARE 2@-ELEMENT ARRAY 
SETS TENTH ELEMENT=ABC 
SETS &C=TENTH ELEMENT (ABC) 


*KERROR** ONLY 26 ELEMENTS 
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SETB—Assign Binary Value 


SETB assigns a binary bit value to a SETB symbol. You can assign bit values zero or one 
to a SETB symbol directly and use it as a switch. If you specify a logical expression in the 
operand field, the assembler evaluates this expression to determine whether it is true or 
false and then assigns the values one or zero, respectively. You can use the computed 
value in condition tests or for substitution. 

The format of the SETB instruction is: 


variable SETB 
symbol 


The symbol in the name field must have been previously declared as a SETB symbol in 
a GBLB or LCLB instruction. The 3 options you can specify in the operand field are: 

e A binary value, 0 or 1 
e A binary value enclosed in parentheses, (0) or (1) 
e A logical expression enclosed in parentheses : 

The assembler evaluates a logical expression and determines if it is true or false. If it is 
true, it is given a value of 1; if it is false, a value of 0. The assembler assigns the explicitly 
specified binary value (0 or 1) or the computed logical value (0 or 1) to the SETB symbol 
in the name field. For example: 









one of 3 options 








* SETB INSTRUCTION | VALUE ASSIGNED | 

eo | 

Bl 7 i 

6B3 Ss SET Retr eee eee te eee ene 
SBA a) ae 
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The SETB symbol in the name field can be subscripted, but only if the same SETB 
symbol has been previously declared in a GBLB or LCLB instruction with an allowable 
dimension. If the symbol in the name field is subscripted, the assembler assigns the binary 
value explicitly specified or implicit in the logical expression to the position in the 
declared array given by the value of the subscript. The subscript expression must not (1) 
be zero, (2) have a negative value, or (3) exceed the dimension specified in the 
declaration. For example: 


* INSTRUCTIONS DESCRIPTION 

* 
LCLB &B EG at Meh 
LCLB sSUBSCR(59) DECLARES 5Q-ELEMENT ARRAY 


ee ee | SETS TENTH ELEMENT#] = 





SB —«sSETB__- sSUBSCR(1f) SETS SB=TENTH ELEMENT(m1) 
6SUBSCR(72) SETB | -RRERROR** ONLY 5 ELEMENTS 


Using Expressions in SET Instructions 
You can use three types of expressions in conditional assembly instructions: arithmetic, 
character, and logical. The assembler evaluates these conditional assembly expressions at 
preassembly time. 
Do not confuse the conditional assembly expressions with the absolute or relocatable 
expressions used in other assembler language instructions. The assembler evaluates 
absolute and relocatable expressions at assembly time. 
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Arithmetic (SETA) Expressions 
You can use an arithmetic expression to assign an arithmetic value to a SETA symbol, or 
to provide subscripting values during conditional assembly processing. 
An arithmetic expression can contain one or more SET symbols. This allows you to use 
arithmetic expressions wherever you wish to specify varying values, for example as: 
e Subscripts for SET symbols 
e Subscripts for symbolic parameters 
e Subscripts for &SYSLIST 
e Substring notation 
Thus you can control loops, vary the results of computations, and produce different 
values for substitution into the same model statement. 
Arithmetic expressions can be used as shown below: 


SETA instruction &A1l SETA &A1+2 


AIF instruction comparand in AIF (&A*10 GT 30) .A 
or arithmetic 
SETB instruction relation 


Subscripted SET subscript &SETSYM(&A+10—&C) 
symbols 


Substring notation ‘& STRING’ (&A*2, &A — 1) 


Sublist notation subscript Sublist: (A, B, C, D) 
When &A = 1 the value of 




























&PARAM (&A + 1) is B. 


&SYSLIST (&M +1, &N — 2) 
&SYSLIST (N ‘&SYSLIST) 


















SETC instruction character &C SETC ‘5—10*&A’ 
string in If &A = 10 then 
operand &C =5-10*10. 


Note. When an arithmetic expression is used in the operand field of a SETC instruction, 
the assembler assigns the character string representing the arithmetic expression to the 
SETC symbol, after substituting values into any variable symbols. It does not evaluate the 
arithmetic expression. 
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An arithmetic expression consists of one or more arithmetic terms combined with the 
arithmetic operators + (addition), — (subtraction), * (multiplication), and / (division). An 
arithmetic term can be any of the following: 


e self-defining term 
® count or number attribute reference 
e variable symbol as follows 


Variable symbols allowed as terms in an arithmetic expression are: 


Value of 
Variable symbol Restriction Example example 
SETA ee ee 
SETB Cees ES ee ee 














SETC Value must be an unsigned 
decimal self-defining term 
Symbolic parameters Value must be a self- &PARAM X‘Al’ 
defining term 
&SYSLIST (n) Corresponding operand &SYSLIST(3) 24 
or or sublist entry must be 
&SYSLIST (n, m) a self-defining term &SYSLIST (3,2) | B‘101’ 














Coding Conditional Assembly Arithmetic Expressions 
The following is a summary of coding rules for arithmetic expressions: 


e¢ Only binary operators are allowed in arithmetic expressions. 

e An arithmetic expression must not begin with an operator, and it must not contain - 
two Operators in succession. 

e An arithmetic expression must not contain two terms in succession. 

e An arithmetic expression must not have blanks between an operator and a term. 

e An arithmetic expression can contain up to 16 terms and up to five levels of 
parentheses. The parentheses required for sublist, substring, and subscript notation 
count toward this limit. 
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Evaluation of Arithmetic Expressions 


6-50 SC34-0074 


The assembler evaluates arithmetic expressions at preassembly time as follows. 


e It evaluates each arithmetic term. 

e It performs arithmetic operations from left to right; however, it performs the 
operations of multiplication and division before the operations of addition and 
subtraction. 

e In division, it gives an integer result; any fractional portion is dropped. Division by 
zero gives a zero result. 

e In parenthesized arithmetic expressions, the assembler evaluates the innermost 
expressions first and then considers them as arithmetic terms in the next outer level of 
expressions. It continues this process until the outermost expression is evaluated. 

e The computed result, including intermediate values, must be in the range ~23! 
through +2°'-1. 


For example, the expression 
&At(X‘SFF *2+&B-(&C/2+KS&AREA)) 


would be evaluated in the order: 


(1) evaluate &C 

(2) evaluate &C/2 

(3) evaluate K‘“R AREA 

(4) evaluate result of (2) + result of (3) 
(5S) evaluate X‘FF’*2 

(6) evaluate &B 

(7) evaluate result of (5S) + result of (6) 
(8) evaluate result of (7) — result of (4) 
(9) evaluate &A 

(10) evaluate result of (9)+ result of (8) 
Note. Self-defining terms are limited by assembly-time constraints; they must be in the 
range —2!°© through +21 °-1. 

The performance time of the assembler may be affected by the way SETA expressions 
are coded if large values are being used. The timing on multiply operations will be 
improved if the larger of the two values is placed first in the expression. When possible, 
write the expression so that the partial results of division operations will be small values. 
For example, the expression 600/300*10 gives the same result as 10*600/300, but the 
first expression will be evaluated in less time than the second. However, loss of precision 
must be considered when using divide because fractional integers, in partial results, are 
dropped. For example: 2*9/6 gives a result of 3, while 9/6*2 gives a result of 2. 


Value of variable symbol Value of expression 


&A + 10/&B 
(&A +10) /&B 
&A/2 
&A/2 
&A/2 
10*&A/2 













Character (SETC) Expressions 


The main purpose of a character expression is to assign a character value to a SETC 
symbol. You can then use the SETC symbol to substitute the character string into a 
model statement. You can also use a character expression as a value for comparison in 
condition tests and logical expressions. In addition, a character expression provides the 
string from which you can select characters with substring notation. 

Substitution of one or more character values into a character expression allows you to 
use the character expression wherever you need to vary values for substitution or to 
control loops. 

You can use character (SETC) expressions in conditional assembly instructions only as 
follows: 

e In SETC instruction as an operand; for example: 
&C SETC ‘STRINGO’ 
e In AIF or SETB instructions as a character string in character relation; for example: 
AIF (‘&C’ EQ ‘STRING1’).B 
e In substring notation as the first part of the notation; for example: 
‘SELECT’(2,5) 
where “SELECT? is a character expression 

A character expression consists of any combination of characters enclosed in 
apostrophes. Variable symbols are allowed. The assembler substitutes the representation 
of their values as character strings into the character expression before evaluating the 
expression. 

Note. Up to 127 characters are allowed in a character expression. Attribute references are 
not allowed in character expressions. 

Variable symbols used in character expressions are subject to the following restrictions: 


SETA Sign and leading &A SETA 0-201 —201 
zeros are &C SETC ‘&A’ 201 
suppressed; stand- &D SETC 0105 105 
alone zero is used &ZERO SETA 0 0 
SETB Must be 0 or 1 &B SETB 1 1 
&C SETC ‘&B’ 1 
SETC None &C1 SETC ‘ABC’ ABC 
&C2 SETC ‘&C1’ ABC 
Symbolic None & C1 SETC ‘&PARAM’ (ABC) 
if PARAM is (ABC) 


&NUM SETC‘ssYSNDX | 0201 






















System 
variable 
symbols 






if &S YSNDX = 0201 
Note. Leading zeros are 
not suppressed 
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Evaluation of Character Expressions 


The value of a character expression is the character string within the enclosing 
apostrophes, after the assembler performs any substitution for variable symbols. 
Character expressions can be concatenated with each other or with substring notations in 
any order. You can then use the concatenated string in the operand field of a SETC 
instruction or as a value for comparison in a logical expression. The resultant string is the 
value of the expression used in conditional assembly operations: for example, the value 
assigned to a SETC symbol. Only the first 8 characters of the resultant string are assigned 
to a SETC symbol. You must code a double apostrophe to generate a single apostrophe as 
part of the value of a character expression. A double ampersand generates a double 
ampersand as part of the value of a character expression. To generate a single ampersand 
in a character expression, use the substring notation: for example (&&’(1,1)). To 
generate a period following a variable symbol, either you must code 2 periods or the 
variable symbol must have a period as part of its value. You must code the concatenation 
character (a period) to separate the apostrophe that ends one character expression from 
the apostrophe that begins the next. For example: 


Example Value of variable Value of character 
symbols used expression 


‘ABC’ : ABC 
‘&PARAM’ &PARAM = SYMBOL SYMBOL 
‘&A +10’ &A=10 10 +10 
‘& A&A’ &A = 10 1010 
aC. &C &C = DEF DEFDEF 
‘&C. ABC’ DEFABC 
‘ABC&D’ ; ABC. 
‘&E’ null character 
string 
‘ABC&D. DEF’ ABCDEF 
‘&C.. 505’ 2.505 
*&C.505’ ; 2.505 
‘ABC’. ‘DEF’ ABCDEF 
‘ABC’. ‘ABCDEFP’ (4, 3) ABCDEF 
‘&C’ (4, 3). ‘DEF’ &C = ABCDEF DEFDEF 
‘&C’ (4, 3) ‘DEF’ &C = ABCDEF DEFDEF 
‘ABC’. ‘&C’. ‘DEF’ &C = null ABCDEF 
‘ABC’, ‘’ . ‘DEF’ ABCDEF 





Logical (SETB) Expressions 

You can use logical (Boolean) expressions to assign the binary value 1 or 0 to a SETB 
symbol. You can also use a logical expression to represent the condition test in an AIF 
instruction. This allows you to code a logical expression whose value (0 or 1) will vary 
according to the values substituted into the expression and thereby determine whether or 
not a preassembly branch is taken. 

You can code logical (SETB) expressions in conditional assembly instructions only as 
follows: 


e In SETB instructions as the operand; for example: 


sBl SETB (&B2 OR 8 GT 3) 





e In AIF instructions as the condition test part of the operand; example: 


AIF (NOT &Bl OR 8 EQ 3).A 
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A logical expression consists of one or more logical terms connected by the logical 
Operators: 
e OR~—addition 
e AND—multiplication 
e NOT—negation 
The logical operators OR and AND must connect two logical terms; the logical operator 
NOT is a unary operator—it precedes a single logical term to indicate the negation of that 
term. 
A logical term can be either: 
e A SETB variable symbol, or 
e A logical relation, which is one of the following: 
— An arithmetic relation: 2 arithmetic expressions separated by a relational operator 
— A character relation: 2 character strings (character expression, substring notation, 
type attribute reference, or concatenation of character expression and substring 
notation) separated by a relational operator 
The relational operators are: 
— EQ (equal) 
NE (not equal) 
LE (less than or equal) 
— LT (less than) 
GE (greater than or equal) 
GT (greater than) 


Macro Language 6-53 


Rules for Coding Logical Expressions 
A summary of coding rules for logical expressions follows: 


e A logical expression must be enclosed in parentheses. 

A logical expression must not contain two logical terms in succession. 

A logical expression can begin with the logical operator NOT. 

A logical expression can contain two logical operators in succession; however, the only 

combinations allowed are: OR NOT or AND NOT. The two operators must be 

separated from each other by one or more blanks. 

e Any logical term, relation, or inner logical expression can be optionally enclosed in 
parentheses. 

e Relational and logical operators must be immediately preceded by a right parenthesis, 
a single quote, or at least one blank. 

e Relational and logical operators must be immediately followed by an ampersand, a left 
parenthesis, a single quote, or at least one blank. 

e A logical expression can contain up to 16 terms and up to five levels of parentheses. 


Following are examples of logical expressions: 


Examples of logical expressions 


(&A GT 100 OR ‘&C’ EQ ‘F’) 


(NOT &B OR (NOT (&A GT 100) ) ) 


arithmetic relation 
character relation | 


(NOT (‘&C’ EQ F) ) 


logical term logical expression 


(NOT (&B) OR (&A GE 10 AND &A LE 0) ) 
(NOT &B OR &A GE 10 AND &A LE 0) 
(&C EQ ‘ALLOC’) 

(‘&CEQ’ALLOC) 

(&A NE, 10) 


blank mandatory 
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Evaluation of Logical Expressions 


The assembler evaluates logical expressions as follows. 


1. 
Z 


It evaluates each logical term, and assigns a binary value of 0 or 1. 

If the logical term is an arithmetic or character relation, the assembler evaluates: 

a. The arithmetic or character expression specified as values for comparison, and 
then 

b. The arithmetic or character relations, and finally 

c. The logical term, which is the result of the relation. If the relation is true, the 
logical term it represents is given a value of 1; if the relation is false, the term is 
given the value of 0. 

Note. If two comparands in a character relation have character values of unequal 

length, the assembler always takes the shorter character value to be less than the 

longer one. 


The assembler performs logical operations from left to right. However: 
a. It performs logical NOTs before logical ANDs and ORs, 

and 
b. It performs logical ANDs before logical ORs. 
In parenthesized logical expressions, the assembler evaluates the innermost 
expressions first and then considers them as logical terms in the next outer level of 
expressions. It continues this process until the outermost expression is evaluated. For 
example, the expression 


(NOT (&B1 OR (&B2 AND (‘&C’ EQ ‘X’ OR &B3)))) 
would be evaluated in the order: 


(1) 
(2) 
(3) 
(4) 
(5) 


evaluate “&C’ EQ ‘X’ 

evaluate the result of (1) OR &B3 
evaluate &B2 AND the result of (2) 
evaluate &B1 OR the result of (3) 
evaluate NOT the result of (4) 


Following are examples of logical expressions: 





Examples of logical expressions 


((&A NE 100) OR T'&AREA EQ ‘&PARAM’(3,4)) 


(‘ABC’ LT ‘ABCD’) (Always true) 


(&B AND NOT (5 GT 3)) 


(&B AND (NOT (5 GT 3))) 


(&B OR &A AND (‘&C EQ ‘B’)) 


(&B OR (&A AND (‘&C’ EQ ‘B’)) 
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Selecting Characters From a String—Substring Notation 


Branching 
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The substring notation allows you to refer to one or more characters within a character 
string. You can select characters from the string and use them for substitution or testing. 
By concatenating substrings with other substrings or character strings, you can rearrange 
and build your own strings. 

Substring notation can be used only in the following conditional assembly instructions: 


e SETC instruction as an operand or part of an operand; for example: 
— &C1 SETC ‘ABC’(1,3) 
assigns the value ABC to &C1 
— &C2 SETC ‘&C1°(1,2).“DEF’ 
assigns the value ABDEF to &C2, based on &C1=ABC 
e SETB and AIF instructions as a character value in the comparand of a character 
relation comprising part of a logical expression; for example: 
— AIF (&STRING’(1,4) EQ ‘AREA’).SEQ 
— &B SETB (‘&STRING’(1,4).°9’ EQ ‘FULL9’) 
Substring notation has the following format: 
‘character string’(e1,e2) 


where the character string must be a valid character expression with a length N in the 
range 1—127 characters, and the subscripts el and e2 are arithmetic expressions. The first 
subscript, el, indicates the first character that is extracted from the character string; the 
second subscript, e2, indicates the number of characters extracted (or the length of the 
substring). Substring notation is replaced by a value that depends on the 3 elements N, 
el, and e2 as follows: 


e When el has a value of zero or a negative value, the assembler issues an error message. 

e When the value of el exceeds N, the assembler issues a warning message, and a null 
character string is generated. 

e When e2 has a value of zero, the assembler generates a null character string. Note that 
if e2 is negative, the assembler issues an error message. 

e When e2 indexes past the end of the character expression (that is, e1+e2 is greater than 
N+1), the assembler issues a warning message and generates a substring that includes 
only the characters up to the end of the character expression (e2 must be less than or 
equal to 8). 

The following examples indicate the results of valid and invalid substring notation: 

e ‘ABCDEF’(2,5) 

Valid; results in character value of BCDEF 
© ‘ABCDEF’(0,5) 

Invalid because e1=0; results in null character value 
e ‘ABCDEF’(7,5) 

Invalid because e1 is greater than N; results in null character value 
e ‘ABCDEF’(3,0) 

Invalid because e2=0; results in null character value 

e ‘ABCDEF’(3,5) 

Valid, but produces a warning message because e2 indexes past end of string; results in 
character value of CDEF (only 4 characters long) 

e ‘ABCDEF’(3,4) 

Valid; results in character value of CDEF 


There are four conditional assembly instructions that control the sequence of execution 
of statements within a macro definition: 

e AlF—Conditional branch 

AGO-Unconditional branch 

ACTR—Loop control counter 

ANOP—No Operation 


AIF—Conditional Branch 


“BACK 


AIF is used to: 

e Branch according to the result of a condition test 

e Provide loop control for conditional assembly processing 

e Check for error conditions and branch to an appropriate MNOTE instruction 
Code the AIF instruction as follows: 


sequence logical expression enclosed in parentheses, immediately 
symbolor | AIF followed by a sequence symbol with no intervening 
blank blanks 

















The assembler evaluates the logical expression in the AIF operand field at preassembly 
time. If the logical expression is true (logical value=1), the next statement processed by 
the assembler is the statement identified by the sequence symbol in the operand field of 
the AIF instruction; if the logical expression is false (logical value=0), the next sequential 
statement is processed next. The sequence symbol in the operand field is a conditional 
assembly label (the name field of a model statement or another conditional assembly 
instruction) that represents a location at preassembly time; the label can appear before or 
after the AIF instruction, within the same macro definition as the corresponding AIF 
instruction. 

The following example indicates the use of the AIF instruction: 


—("ec" £Q 'F") .FORWARD 
(8A GT S).BACK 


«FORWARD. NOP 


AGO-— Unconditional Branch 


-MEND 


AGO is used to branch unconditionally. This provides you with final exits from 
conditional assembly loops. 
Code the AGO instruction as follows: 


sequence 


symbol sequence symbol 
or blank 
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The statement identified by the sequence symbol in the AGO instruction operand can 
appear before or after the AGO instruction, within the same macro definition as the 
corresponding AGO instruction. 

The following example indicates the use of the AGO instruction: 


- ee 








ACTR—Assembly Loop Counter 


ACTR is used to set a conditional assembly loop counter. Each time the assembler 
processes an AIF or AGO branching instruction, the loop counter for that macro 
definition is decreased by one. When the number of conditional assembly branches taken 
reaches the value assigned by the ACTR instruction, the assembler exits from the macro 
definition. | 

By using the ACTR instruction, you avoid excessive looping during conditional 
assembly processing at preassembly time (in case of errors). 

The format of the ACTR instruction statement is: 


any valid SETA expression 





The ACTR instruction, if used, must be the first statement following global and local 
declarations for the macro definition. 


A conditional assembly loop counter is set to the value of the arithmetic expression in 
the operand field. The loop counter has a local scope; its value is decreased only by AGO 
and AIF instructions (if the branch is taken). The loop counter is reset each time the 
macro is called. The nesting of macros has no effect on the setting of individual loop 
counters. 

The assembler sets its own internal loop counter for each macro definition that does 
not contain an ACTR instruction. The assembler assigns a standard value of 150 to each 
of these internal loop counters. 

Within the local scope of a particular loop counter (including the internal counters run 
by the assembler), the following rules apply. 


e Each time the assembler executes an AGO or AIF branch, it checks the loop counter 
for a zero value. 

e If the count is not zero, it is decreased by one. 

e If the count is zero, before decreasing the counter value, the assembler terminates the 
expansion of the entire nest of macro definitions and processes the next sequential 
instruction after the outer macro call. 
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ANOP— Assembly No Operation 


You can specify a sequence symbol in the name field of an ANOP instruction, and use the 
symbol as a label for branching purposes. The ANOP instruction performs no operation 
itself. Instead, if you branch to an ANOP instruction, the assembler processes the next 
sequential instruction. You use it preceding an instruction that already has a symbol in its 
name field. For example, if you wanted to branch to a SETC instruction, which requires a 
variable symbol in the name field, you would insert a labeled ANOP instruction 
immediately before the SETC instruction. By branching to the ANOP instruction with an 
AIF or AGO instruction, you would, in effect, be branching to the SETC instruction. 
The format of the ANOP instruction statement is: 


For example: 










sequence 
symbol 


AGO SEQ 


SED AMOR eed cece pe Mee epee oeben ty LES 
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ASSEMBLER PROGRAM LISTING 
The assembler listing consists of six sections ordered as follows: 


External symbol dictionary 
Source and object program 
Relocation dictionary 
Symbol cross-reference table 
Diagnostic messages 
Statistics 


The contents of the listing are controlled by the assembler options list. For a discussion 


of the options, see Chapter 3 of JBM Series/1 Base Program Preparation Facilities 
User’s Guide, SC34-0072. 


External Symbol Dictionary (ESD). 


This section of the listing contains the external symbol dictionary information passed to 
the linkage editor in the object module. The entries describe the control sections, external 
references, and entry points in the source module. Six types of entries with their 
associated fields are shown in the following chart. The circled numbers refer to the | 
corresponding heading in the sample program listing. The Xs indicate entries 
accompanying the designator for each type. 





This column contains the name of every control section, entry point, and external 
symbol. 

This column contains the type designator for the entry, as shown in the table. The 
type designators are defined as: 


SD Section definition. The symbol appears in the field of a CSECT or START 
statement. 

LD Label definition. The symbol appears as the operand of the ENTRY 
statement. 

ER E&xternal reference. The symbol appears as the operand of the EXTRN 
statement or is defined as a V-type address constant, or an external branch 
instruction; for example, BALX. 

PC Private code. Unnamed control section definition. 

WX Weak external reference. The symbol appears as the operand of WXTRN 
statement, or is defined as a W-type address constant. 

This column contains the external symbol dictionary identification number (ESDID), 

a unique 2-digit hexadecimal number identifying the entry. It is also used in an LD 

entry and in the relocation dictionary for cross-referencing the ESD. The assembler 

assigns this number in seqeunce as the items are encountered in your source program. 

This column contains the address of the symbol (hexadecimal notation) for SD and 

LD type entries, and is blank for ER and WX entries. For PC and SD entries, it 

indicates the starting address of the control section. 

This column contains the assembled length, in bytes, of the control section 

(hexadecimal notation). 

This column contains, for LD entries only, the ESDID assigned to the control section 

that defines the entry symbol. 
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PGM ID 
@ret. ID. POS.ID. FLAGS ADDRESS REL, ID. POS.ID. FLAGS ADDRESS 14) 
01 01 00 0102 02 01 10 0106 
01 01 00 O10A 03 01 10 0110 
01 01 00 0116 01 01 00 O11A 














EXTERNAL SYMBOL DICTIONARY 
PGM ID 


0 6oe oO oe O © 
ID 


SYMBOL TYPE ADDR LENGTH LD ID 

















SECTA SD 01 0000 002E 

GAMMA ER 02 

ENTA LD 0118 01 
ALPHA ER 03 


PROCZ WX 04 


ExAM @ 








SAMPLE ASSEMBLY LISTING @ PAGE 1 


PGM D@® 









LOC OBJECT CODE STMT SOURCE STATEMENT 














0100 2 SECTA START X‘0100’ 

3 EXTRN GAMMA 

4 ENTRY ENTA 
0000 5 REGO EQUR 0 
0002 6 REG2 EQUR 2 
0007 7 REG7 EQUR 7 
0100 D020 0120 8 MVD OPND1,REGO 
0104 6F03 0000 9 BAL GAMMA,REG7 
0108 D028 0124 10 MVD REGO,RESULT 
010C 6808 0000 11 MVW OPND2,REGO 
***¥ EF RROR*** 
0110 6F03 0000 12 BALX  ALPHA,REG7 
0114 680D 012A 13 MVW REGO,RESULT2 
0118 14 ENTA EQU + 
0118 6A08 012C 15 MVW ADDRZ,REG2 
011C 6842 0000 16 B (REG2) 









* 


18 . DATA AREA 
* 
0120 0000000A _ OPND1 DC D‘10’ 
0124 21 RESULT DS D 


















0128 0O1E 22 OPND1 DC F°30’ 

*** ERROR*#* 

012A 23 RESULT2 DS F 

012C 0000 24 ADDRZ DC W(PROCZ) 









0000 END 





EXAM RELOCATION DICTIONARY 










04 01 012C 





EXAM CROSS-REFERENCE LISTING PAGE 1 


© 00 © © = 
SYMBOL ESDID LEN VALUE DEFN REFERENCES 
ADDRZ 00 0002 0000 00024 00015 
ALPHA 03 0002 0000 00012 
ENTA 00 0001 0118 00014 00004 
GAMMA 02 0001 0000 00003 00009 
OPND1 00 0004 0120 00020 00008 
OPNDI1 *** DUPLICATE*** 00022 
OPND2 ** *UN DEFINED*** 00011 
PROCZ 04 0001 0000 00024 
REGO RG 0001 0000 00005 00008 00010 
00011 00013 
REG2 RG 0001 0002 00006 00015 00016 
REG7 RG 0001 0007 00007 00009 00012 
RESULT 00 0004 0124 00021 00010 
RESULT2 00 0002 012A 00023 00013 
SECTA 01 0001 0100 00002 
EXAM DIAGNOSTICS PAGE | 
6 6 6 © ™ 
STMT MACRO ERRORCODE MESSAGE 
11 AS220E UNDEFINED SYMBOL 
22 AS219E PREVIOUSLY DEFINED NAME 
EXAM STATISTICS PAGE 1 
PGM ID 


2 STATEMENT(S) FLAGGED IN THIS ASSEMBLY @) 
8 WAS HIGHEST SYSTEM SEVERITY CODE 
0 WAS HIGHEST MACRO SEVERITY CODE 


** OPTIONS IN EFFECT ** 
LIST 
OBJECT 
ESD 
TEXT 
RLD 31) 
XREF 
NOMACRO 


** SPECIFICATIONS IN EFFECT ** 
SYSPARM = ‘FP’ 


25 SOURCE RECORDS READ 
0 MACRO FILE RECORDS READ @®) 
§ OBJECT RECORDS OUTPUT 

79 PRINTED LINES 


OBJECT MODULE EXTENTS - 250001, 250005 @ 
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This section of the listing documents the source statements and the resulting object code. 
@ This is the 4-character object module identification. It is the symbol that appears in 


So 60 


© 


the name field of the first TITLE statement. The assembler prints the object module 
identification and program identification (item 14) on every page of the listing. 
This is the information taken from the operand field of a TITLE statement. 


Note. TITLE, SPACE, and EJECT statements do not appear in the source listing. 


This is the listing page number. Each section of the listing starts with page 1. 

This column contains the location counter value (hexadecimal notation) of the object 

code. For EQU instructions, this column contains the assembled value of the operand 

field. 

This column contains the object code assembled from source statements. The entries 

are always left-justified. The notation is hexadecimal. Entries are either machine 

instructions or data constants. Machine instructions are printed in full with a blank 
inserted after every 4 digits (one word). Constants might be only partially printed, 
depending on the PRINT option in effect. 

This column contains the statement number. A plus sign (+) to the right of the 

number indicates that the statement was generated as the result of expanding a macro 

instruction. 

This column contains the source program statement. The following items apply to 

this section of the listing: 

— Source statements are listed, including macro definitions submitted in the source 
module. 

— Listing contro] instructions are not printed, with one exception. PRINT is listed 
when PRINT ON is in effect. 

— The statements generated as the result of a macro instruction follow the macro 
instruction in the listing unless PRINT NOGEN is in effect. 

— Diagnostic messages are not listed inline in the source and object program section. 
An error indicator, ***ERROR***, follows the statement in error, and appears 
inline when errors occur during macro definition expansion in NOGEN mode. 
(One or more of these indicators appear following the macro call, depending on 
the number of definition statements in error.) The message appears in the 
diagnostic section of the listing. 

— MNOTE messages are listed inline in the source and object program section. They 
are printed even if the NOGEN option is in effect. An MNOTE indicator appears in 
the diagnostic section of the listing for MNOTE statements other than MNOTE *. 
The MNOTE message format is severity code, followed by message text. 

— The MNOTE * form of the MNOTE statement results in an inline message only. 
An MNOTE indicator does not appear in the diagnostic section of the listing. 

— When an error is found in a source macro definition, it is treated the same as any _ 
other assembly error: the error indication appears after the statement in error, and 
a diagnostic is placed in the list of diagnostics. An error encountered during the 
expansion of a macro instruction is indicated at the point of error in the expansion 
and the associated diagnostic message is placed in the list of diagnostics. Errors 
occuring in a macro expansion (print NOGEN mode) are flagged inline with the 
macro call. 

— If the END statement contains an operand, the transfer address appears in the 
location column (LOC). 

— In the case of CSECT and DSECT statements, the location field contains the 
starting address of these control sections. 

— In the case of EXTRN, WXTRN, and ENTRY instructions, the location field and 
object code field are blank. 

— For a USING statement, the location field contains the value of the first operand. 

— For ORG statements, the location field contains the address value of the ORG 
operand. 


Relocation Dictionary 


Cross-reference 


— For an EQU or EQUR statement, the location field contains the value assigned to 
the symbol in the name field. 

— Generated statements always print in standard statement format. Because of this, a 
generated statement can occupy two continuation lines on the listing, unlike 
source statements, which are restricted to one continuation line. 

Program identification. The assembler supplies this information, which identifies 

the assembler program. 


This section of the listing contains the relocation dictionary information passed to the 

linkage editor in the object module. Each line of the listing contains up to three 

relocation dictionary entries. The entries describe all address constants in the source 
module that are affected by relocation. 

15) This column contains the ESDID number assigned to the ESD entry for the control 
section in which the referenced symbol is defined, or the ESDID number assigned to 
an ER item in the ESD. 

@© This column contains the ESDID number assigned to the ESD entry that describes the 
control section in which the address constant is used as an operand. 

The 2-digit hexadecimal number in this column is interpreted as follows: 

First digit. A 0 indicates that the entry describes an A-type address constant. A 1 
indicates that entry describes a V-type address constant. 

Second digit. A O indicates that the relocation factor must be added to this item. A 2 
indicates that the relocation factor must be subtracted. 

@ This column contains the location counter value of the address constant in the source 
module. 


This section of the listing contains all symbolic names used in the source module as well 

as certain information corresponding to the use of each symbolic name. 
This column contains the symbolic names in alphabetic order. 
This column specifies the external symbol dictionary identifier (ESDID) in 
hexadecimal notation for the symbolic name. For register symbols, this field contains 
RG. Register symbols are absolute. An ESDID of X‘O0O’ specifies that the symbol 
value is absolute. An ESDID other than X‘0O’ specifies that the symbol value is 
relocatable and is associated with that identifier. 
This column states the length attribute (decimal notation) assigned to the symbol. 
This column contains either the address the symbol represents, or a value to which 
the symbol is equated (hexadecimal notation). 
This column contains the number of the statement in which the symbol is defined 
(decimal notation). Predefined register symbols will have statement number 0000. 

@ This column contains, from left to right, in ascending order, the numbers (decimal 
notation) of all statements in which the symbol appears in an operand. 

Notes. 


1. A PRINT OFF listing control instruction does not affect the printing of the 
cross-reference section of the listing. 

2. In the case of an undefined symbol, the assembler fills columns 20, 21, 22, and 23 
with the message: 
** * UNDEFINED*** 

3. In the case of duplicate symbols, the assembler fills columns 20, 21, and 22 with the 
message: 
e** DUPLICATE? ** 

4. Symbols appearing in V— or W— type address constants do not appear in the cross- 
reference listing. 
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This section of the listing contains the diagnostic messages issued as a result of error 
conditions encountered in the program. For actual messages, see Appendix M of the JBM 
Series/1 Base Program Preparation Facilities User’s Guide, SC34-0072. 


® This column contains the number of the statement in error. 
This column contains the name of a macro definition whenever certain errors 
associated with that macro definition are encountered. 

@ This column contains the message identification—assembler identifier, message 
number, and severity. 

€ This column contains the message text. In many cases, the assembler indicates the 
vicinity of the error with a near operand column pointer. 


An MNOTE indicator of the form SEVERITY CODE xxx—MNOTE STATEMENT 
appears in the “Diagnostics” section if an MNOTE statement other than MNOTE * is 
issued by a macro instruction. xxx is the severity code associated with the statement 
flagged. The MNOTE statement itself is inline in the source and object program section of 
the listing. The operand field of an MNOTE * is printed as a comment but does not 
appear in the “Diagnostics” section of the listing. 


Note. Editing errors in macro definitions from the macro source file are discovered when 
the macro definitions are read from the macro file. This occurs after the END statement 
has been read. They are therefore flagged after the END statement. The assembler lists 
the names of macro definitions along with error messages associated with those 
definitions. 


This section of the listing contains these statistical messages: 


© This is the number of statements flagged. The statements in error are printed in the 
“Diagnostics” listing. 

€é) This is the highest assembler severity code encountered, if not zero. Your macro 
severity code is also printed. 


Informational message; no effect on execution 
Informational message; normal execution is expected 
Warning message; successful execution is probable 
Error; execution may fail 

Serious error; successful execution is improbable 
Assembler program terminated abnormally 










31] This is a list of the assembler options in effect. Options are discussed in Chapter 3 of 
the JBM __Series/I_ Base Program Preparation Facilities User’s Guide, SC34-0072. 
Note that the MACRO option is printed if the assembly required macro processing; 
that is, if inline macro definitions or macro instructions were coded. 

This is the number of source records processed. 
© These are the extents of the object module, if one was created. 


RECORD FORMATS 


External Symbol Dictionary (ESD) Record Format 


The external symbol dictionary contains all external symbol and storage assignments for 
an object module. The ESD has assignments for: 


e All symbols defined in a module that can be referred to by another module. 
e All symbols defined as external to a module. 


External Symbol Dictionary (ESD) Record 


Bytes and 
Offset bit pattern - Field name Description 


X‘02’ 
ID Record ID; contains C‘ESD’ 
Contains blanks 


LENGTH Number of bytes of ESD information in this 
record. The number is either 16 (X‘10’), 
32 (X‘20’), or 48 (X‘30’) for 1 item, 2 items, 
or 3 items, respectively. 


Contains blanks 


The ESDID number assigned to the first SD, 
PC, ER, or WX item in this record. For 
example, the field would contain X‘0001’ 
for an ESDID number of 01. This ESDID 
number associates the SD, PC, ER, or WX 
item to a particular control section. This 
field contains blanks (X*4040’) if all ESD 
items in this record are LD items. 


16 (10) ESD items. A maximum of three 16-bytes 
ESD entries. 


72 (48) Module identification field 
76 (4C) Module sequence field 
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The format of a 16-byte ESD item in the preceding record is: 


Bytes and 
bit pattern Field name Description 


SYMBOL Symbolic name field. This field contains the. . °: 
symbolic name, in EBCDIC, for all SD, LD, 
ER, and WX items. The field contains blanks 
for PC items. 


Type code: 

SD (section defintion) 

LD (label definition) 

ER (external reference) 

PC (private code) 

WX (weak external reference) 


ADDRESS The assembled byte address assigned to this 
item—blanks if the type is ER or WX 


Must contain a blank 


For ER and WX items, this field contains 
blanks (X‘°4040’). 

For LD items, this field contains the 
ESDID number of the control section (SD 
item) containing the symbolic name. 

For SD and PC items, this field contains the 
hexadecimal length of the control section. This 
length is expressed in bytes. 


The text records contain the instructions and data words that are to be incorporated by 
the linkage editor into a load module. Each text record contains the origin address of the 
instructions or data included in the record and also the count of the number of bytes 
contained in the record. A reference to the control section in which this information 
occurs is included in the text record to permit the proper relocation factor to be applied. 


Bytes and 
Offset bit pattern Field name Description 


0 (0) 1 CODE X‘02’ 

1 (1) 3 ID Record ID; contains C‘TXT’ 

4 (4) 2 Unused; contains blanks 

5 (5) 2 ADDRESS The 24-bit address of the text data in this 


record 
8 (8) Unused; contains blanks 


10 (A) 2 LENGTH The number of bytes of text data in this 
record 

12 (C) 2 Unused; contains blanks 

14 (E) 2 ESDID ESDID of the control section containing 
the data in this record . 
16 (10) 56 DATA Text data;a maximum of 56 bytes (28 
sixteen-bit words) of text data 

Module identification field 


72 (48) 
76 (4C) 4 Module sequence field 





Relocation List Dictionary (RLD) Record Format 


The relocation list dictionary records identify portions of the text that must be modified 
because of relocation. RLD records are generated by relocatable address constants in a 
source module. 


Relocation Dictionary (RLD) Record 


Bytes and 
Offset bit pattern Field name Description 


0 (0) | X‘02’ 
1 (1) ID Record ID; contains C‘RLD’ 
4 (4) Unused; contains blanks 


10 (A) The number of bytes RLD data in this 
record. The maximum number is X‘38’. 


Unused; contains blanks 


RLD items. These items are either 4 or 8 
bytes long. The first item in each RLD 
record is always 8 bytes long. 


Module identification field. 
Module sequence field 





















LENGTH 










12 (C) 
16 (10) 













72 (48) 
76 (4C) 





Relocation pointer (R-pointer); the ESDID number of the control section 
containing the referenced symbol 


Position pointer (P-pointer); the ESDID number of the control section 
containing the address constant reference 


When byte format is xxxxLLST, 
XXxx specifies the type of this RLD item (address constant). 
0000 — non-branch type address constant 
0001 — branch type address constant 
0010 — *** reserved *** 
0011 — *** reserved *** 
LL specifies the length of the address constant. 
01 — two bytes (note. only value supported) 
10 — *** reserved *** 
11 — *** reserved *** 
S specifies the direction of relocation. 
0 — positive (+ ) relocation 
1 — negative (—) relocation 
T specifies the type of the next RLD item. 
0 — the following RLD item has a different R and/or P 
pointer and occupies 8 bytes. 
1 — the following RLD item has the same R and P pointers 
and occupies 4 bytes. 


ADDRESS The assembled byte address of the reference. This address is within the 
control section referenced by the P-pointer field. 
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The END record indicates the end of an object module to the linkage editor. This record 
can also contain the control section length if it was not previously specified in the ESD 
SD item. 

The END record of the object module has the following format: 


. Bytesand | 
Offset bit pattern Field name Description 


X‘02’ 
Record ID; contains C‘-END’ 
Unused; contains blanks 













1 
3 
1 
3 


This field contains the assembled entry 
point to this module, if specified in the 
END assembler source statement. The entry 
point is expressed as a byte address. If the 
entry is not specified in the END statement, 
this field contains blanks. 


Unused; contains blanks 


ESDID number of the control section con- 
taining the entry point specified in bytes 5, 
6, and 7. If no entry point is specified in the 
END assembler source statement, this field 
contains blanks (X‘*4040’). 


Unused; contains blanks 


Module identification field. 

























16 (10) 
72 (48) 
76 (AC) 





Module sequence field 


Appendix A. Decimal/Binary/Hexadecimal Conversions 


DECIMAL TO BINARY CONVERSION 


Several methods exist for converting binary numbers to decimal numbers. The method 
used here is repetitive division. To find the binary equivalent of a decimal number: 


Divide the decimal number by 2. 

Save the remainder (0 or 1). 

. Divide the quotient by 2. 

. Repeat steps 2 and 3 until the quotient can no longer be divided. The last quotient is 
the last remainder. 


BwON 


Example: Convert decimal 236 to binary. 


118 R=0 
2/ 236 


59 R=0 
2/118 
29 R=1 
2/59 
14 R=1 
2 /29 
7 R=0 
2/14 
a. R=1 
2/7 
R=1 


l 
2/3 


R=1 Last quotient 


To represent this binary number in a byte: first, assign the units position of the binary 
number the value 1, the tens position the value 2, and the hundreds position the value 4. 
Doubling the value each time, assign values to all bit positions through the high-order bit 
as shown in the following example: 


Bit position 


- Decimal 


: 128 
assigned values 
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Second, take the remainders you obtained in the division process and place them in each 
bit position. Place the first remainder in bit position 7. Fill all unused high-order bits with 
0. 


Bit position 


Decimal! 
assigned value 


Binary 
value of 236 





BINARY TO DECIMAL CONVERSION 


To convert from binary to decimal: add the decimal equivalent of each bit position that 
contains 1. In this example, binary 1110 1100 = 128 + 64 + 32 + 8 + 4 = 236 decimal. 


BINARY TO HEXADECIMAL CONVERSION 


Hexadecimal numbering is similar to decimal numbering. However, since the hexadecimal 
base is 16, numbers greater than 9 are assigned alphabetic equivalents, as follows: 


Decimal Hexadecimal 
0 0 
1 1 
2 Z 
3 3 
4 4 
5 5 
6 6 
7 di 
8 8 
9 9 
10 A 
11 B 
12 C 
13 D 
14 E 
15 F 
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Four binary bits represent a hexadecimal number. 


Binary Hexadecimal 


0000 
0001 
0010 
0011 
0100 
0101 
0110 
O111 
1000 
1001 
1010 
1011 
1100 
1101 
1110 
1111 


MINOAWP>r OMADUNAWHKO 


Two hexadecimal numbers are represented in a byte. Bit positions O—3 represent the first 
hexadecimal character, and bit positions 4—7 represent the second hexadecimal character. 
The following examples show the hexadecimal equivalents of one-byte binary numbers. 


One-byte binary number Hexadecimal equivalent 


First Second 
character character 


Bit position 


Examples 





Figure A-1 gives the binary, decimal, and hexadecimal equivalents from 0 to 255. Where 
applicable, equivalent printer graphics are also shown. 
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First Second First Second 
half byte half byte half byte half byte | 
128 Printer Hexa- 128 Printer Hexa- 
64 graphic decimal 64 graphic decimal 
32 ( 32 
¢ 16 [rt6 
8421 8421 
0000 0000 0 00 0100 0001 65 41 
0000 0001 1 01 0100 0010 66 42 
0000 0010 2 02 0100 0011 67 43 
0000 0011 3 03 0100 0100 68 44 
0000 0100 4 04 0100 0101 69 45 
0000 0101 5 05 0100 0110 70 46 
0000 | 0110 6 06 0100 0111 71 47 
0000 0111 7 07 0100 1000 72 48 
0000 1000 8 08 0100 1001 73 49 
0000 1001 9 09 0100 1010 74 4A 
0000 1010 10 0A 0100 1011 . (period) 75 4B 
0000 1011 11 OB 0100 1100 < 76 4C 
0000 1100 12 Oc 0100 1101 ( 77 4D 
0000 1101 13 OD 0100 1110 + 78 4E 
0000 1110 14 OE 0100 1111 79 4F 
0000 1111 15 OF 0101 0000 & 80 50 
0001 0000 16 10 0101 0001 81 51 
0001 0001 17 11 0101 0010 82 52 
0001 0010 18 12 0101 0011 83 53 
0001 0011 19 13 0101 0100 84 54 
0001 0100 20 14 0101 0101 85 55 
0001 0101 21 15 0101 0110 86 56 
0001 0110 22 16 0101 0111 87 57 
0001 0111 23 17 0101 1000 88 58 
0001 1000 24 18 0101 1001 89 59 
0001 ~ 1001 25 19 0101 1010 90 5A 
0001 1010 26 1A 0101 1011 $ 91 5B 
0001 1011 27 1B 0101 1100 * 92 5C 
0001 1100 28 1C 0101 1101 ) 93 5D 
0001 1101 29 1D 0101 1110 94 5E 
0001 1110 30 1E 0101 1111 95 5F 
0001 1111 31 1F 0110 0000 ~ 96 60 
0010 0000 32 20 0110 0001 / 97 61 
0010 0001 33 21 0110 0010 98 62 
0010 0010 34 22 0110 0011 99 63 
0010 0011 35 23 0110 0100 100 64 
0010 0100 36 24 0110 0101 101 65 
0010 0101 37 25 0110 0110 102 66 
0010 0110 38 26 0110 0111 103 67 
0010 0111 39 27 0110 1000 104 68 
0010 1000 40 28 0110 1001 105 69 
0010 1001 41 29 0110 1010 106 6A 
0010 1010 42 2A 0110 1011 ; 107 6B 
0010 1011 43 2B 0110 1100 % 108 6C 
0010 1100 44 : 2C 0110 1101 109 6D 
0010 1101 45 2D 0110 1110 110 6E 
0010 1110 46 2E 0110 1111 111 6F 
0010 1111 47 2F 0111 0000 112 70 
0011 0000 48 30 0111 0001 113 71 
0011 0001 49 31 0111 0010 114 72 
0011 0010 50 32 0111 0011 115 73 
0011 0011 51 33 0111 0100 116 74 
0011 0100 52 34 0111 0101 117 75 
0011 0101 53 35 0111 0110 118 76 
0011 0110 54 36 0111 0111 119 77 
0011 0111 55 37 0111 1000 120 78 
0011 1000 56 38 0111 1001 121 79 
0011 1001 57 39 0111 1010 : 122 7A 
0011 1010 58 3A 0111 1011 # 123 7B 
0011 1011 59 3B 0111 1100 @ 124 7¢ 
0011 1100 60 3C 0111 1101 : 125 70 
0011 1101 61 3D 0111 1110 = 126 7E 
0011 1110 62 3E 0111 1111 127 7F 
0011 1111 63 3F 1000 0000 128 80 
0100 0000 blank 64 40 1000 0001 a 129 81 


Figure A-1 (Part 1 of 2). EBCDIC, hexadecimal, decimal table 
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First Second First Second 

half byte half byte half byte half byte 

128 Printer Beene Hexa- 128 Printer imal Hexa- 

4 graphic vole decimal graphic Decima decimal 
32 ((2 
{16 | fri 

8421 8421 

1000 0010 b 130 . 82 1100 0001 A 193 C1 
1000 0011 Cc 131 ' 83 1100. 0010 B 194 C2 
1000 0100 d 132 84 1100 0011 Cc 195 C3 
1000 0101 e 133 85 1100 0100 D 196 C4 
1000 0110 f 134 86 1100 0101 E 197 C5 
1000 0111 g 135 87 1100 0110 F 198 C6 
1000 1000 h 136 88 1100 0111 G 199 C7 
1000 . 1001 i 137 89 1100 1000 H 200 cs 
1000 1010 138 8A 1100 1001 \ 201 c9 
1000 1011 139 8B 1100 1010 202 CA 
1000 1100 . 140 8C 1100 1011 203 CB 
1000 1101 141 8D 1100 1100 204 CC 
1000 1110 142 8E 1100 1101 205 CD 
1000 1111 143 8F 1100 1110 206 CE 
1001 0000 144 90 1100 1111 207 CF 
1001 0001 j 145 91 1101 0000 208 DO 
1001 0010 k 146 92 1101 0001 J 209 D1 
1001 0011 | 147 93 1101 0010 K 210 D2 
1001 0100 m 148 94 1101 0011 L 211 D3 
1001 . 0101 n 149 95 1101 0100 M 212 D4 
1001 0110 oO 150 96 1101 0101 N 213 D5 
1001 0111 p 151 97 1101 0110 O 214 D6 
1001 1000 q 152 98 1101 0111 P 215 D7 
1001 1001 r 153 99 1101 1000 Q 216 D8 
1001 1010 154 9A 1101 1001 R 217 D9 
1001 1011 155 9B 1101 1010 218 DA 
1001 1100 156 9C 1101 1011 219 DB 
1001 1101 157 9D 1101 1100 220 DC 
1001 1110 158 9E 1101 1101 221 DD 
1001 11171 159 © OF 1101 1110 222 DE 
1010 0000 160 AO 1101 1111 223 DF 
1010 0001 161 Al 1110 0000 224 EO 
1010 0010 S 162 A2 1110 0001 225 E1 
1010 0011 t 163 A3 1110 0010 S 226 E2 
1010 0100 u 164 A4 1110 0011 T 227 E3 
1010 0101 v 165. AS 1110 0100 U - 228 E4 
1010 0110 w 166 A6 1110 0101 V 229 E5 
1010 0111 x 167 A7 1110 0110 WwW 230 E6 
1010 1000 y 168 A8 1110 0111 Xx 231 E7 
1010 1001 z 169 AQ 1110 1000 Y 232 E8 
1010 1010 170 AA 1110 1001 Zz 233 E9 
1010 1011 171 AB 1110 1010 234 EA 
1010 1100 172 AC 1110 1011 235 EB 
1010 1101 173 AD 1110 1100 236 EC 
1010 1110 174 AE 1110 1101 237 ED 
1010 1111 175 AF 1110 1110 238 EE 
1011 0000 176 BO 1110 1111 239 EF 
1011 0001 177 B1 1111 0000 0 240 FO 
1011 0010 178 B2 1111 0001 1 241 F1 
1011 0011 179 B3 1111 0010 2 242 F2 
1011 0100 180 B4 1111 0011 3 243 F3 
1011 - 0101 181 BS 1111 0100 4 244 F4 
1011 0110 182 B6 1111 0101 5 245 F5 
1011 0111 183 B7 1111 0110 6 246 F6 
1011 1000 184 B8 1111 0111 7 247 F7 
1011 1001 185 BS 1111 1000 8 248 F8 
1011 1010 186 BA 1111 1001 9 249 F9 
1011 1011 187 BB 1111 1010 250 FA 
1011 1100 188 BC 1111 1011 251 FB 
1011 1101 . 189 BD 1111 1100 252 FC 
1011 1110 190 BE 1111 1101 253 FD 
1011 1111 191 BF 1111 1110 254 FE 


1100 0000 192 co 1111 1111 255 FF 


Figure A-1 (Part 2 of 2). EBCDIC, hexadecimal, decimal table 


Decimal/Binary/Hexadecimal Conversions A-5 


Hexadecimal/Decimal Conversion 
Figure.A-2 provides direct conversion of decimal and hexadecimal numbers in these ranges: 
Hexadecimal Decimal | 
000 to FFF 0000 to 4095 


Decimal numbers are within the table. The first two hexadecimal characters are in the 
left column of the table; the third hexadecimal character (x) is arranged across the top of 
the table. | 

For numbers outside the range of the table, add the following values to the table figures. 


Hexadecimal Decimal 
1000 4096 
2000 8192 
3000 12288 
4000 16384 
5000 20480 
6000 24576 
7000 28672 
8000 32768 
9000 36864 
A000 40960 
B000 45056 
C000 49152 
D000 53248 
E000 57344 
F000 61440 


DECIMAL TO HEXADECIMAL 
To convert from decimal to hexadecimal using Figure A-2: 


1. Find the decimal number in the table. 
2. Determine the hexadecimal number. 
a. Locate the hexadecimal characters in the left column. 
b. Substitute the value for x (the character in the top column above the decimal number). 


Example: Decimal 123 is equivalent to hexadecimal 07B; decimal 1478 is equivalent to 
hexadecimal 5C6. 


HEXADECIMAL TO DECIMAL 
To find the decimal equivalent of a hexadecimal number using Figure A-2: 


1. Find the first two hexadecimal characters in the left column. | 
2. Scan across this row until you find the column containing the last hexadecimal charac- 
ter. Here is the decimal number. 


Example: Find decimal equivalent of hexadecimal OC9. Find OC in the left column. Look 
under column 9. The decimal number is 0201. 


A-6 SC34-0074 


1 2 3 4 5 6 7 8 9 A B C D E F 


0001 0002 0003 0004 0005 0006 0007 0008 0009 0010 0011 0012 0013 0014 0015 
0017. 0018 0019 0020 0021 0022 0023 0024 0025 0026 0027 +0028 0029 0030 0031 
0033 0034 0035 0036 0037 0038 0039 0040 0041 0042 0043 0044 0045 0046 0047 
0049 0050 0051 0052 0053 0054 0055 0056 0057 0058 0059 0060 0061 0062 0063 


0065 0066 0067 0068 0069 0070 0071 +0072 0073 0074 +0075 0076 0077 0078 «0079 
0081 0082 0083 0084 0085 0086 0087 0088 0089 0090 0091 0092 0093 0094 0095 
0097 0098 0099 0100 0101 0102 0103 0104 0105 0106 0107 0108 0109 0110 0111 
0113. 0114 0115 0116 0117 O118 0119 0120 0121 0122 0123 0124 0125 0126 0127 


0129 0130 0131 0132 0133 0134 0135 0136 0137 0138 0139 0140 0141 0142 0143 
0145 0146 0147 0148 0149 0150 0151 0152 0153 0154 0155 0156 0157 0158 0159 
0161 0162 0163 0164 0165 0166 0167 O168 0169 0170 O171 0172 0173 0174 0175 
0177. 0178 0179 0180 0181 0182 0183 0184 0185 0186 0187 0188 0189 0190 0191 


0193 0194 0195 0196 0197 0198 0199 0200 0201 0202 0203 0204 0205 0206 0207 
0209 0210 0211 0212 0213 0214 0215 0216 0217 0218 0219 0220 0221 0222 0223 
0225 0226 0227 0228 0229 0230 0231 0232 0233 0234 0235 0236 0237 0238 0239 
0241 0242 0243 0244 0245 0246 0247 0248 0249 O250 0251 0252 0253 0254 0255 


0257 0258 0259 0260 0261 0262 0263 0264 0265 0266 0267 0268 0269 0270 0271 
0273 0274 0275 0276 0277 0278 0279 0280 0281 0282 0283 0284 0285 0286 0287 
0289 0290 0291 0292 0293 0294 0295 0296 0297 0298 0299 0300 90301 0302 0303 
0305 0306 0307 0308 0309 0310 0311 0312 0313 0314 0315 0316 0317 0318 0319 


0321 0322 0323 0324 0325 0326 0327 0328 0329 0330 0331 0332 0333 0334 0335 
0337 0338 0339 0340 0341 0342 0343 0344 0345 0346 0347 0348 0349 0350 0351 
0353 0354 0355 0356 0357 0358 0359 0360 0361 0362 0363 0364 0365 0366 0367 
0369 0370 0371 0372 0373 0374 0375 0376 0377 0378 0379 0380 0381 0382 0383 


0385 0386 0387 0388 0389 0390 0391 0392 0393 0394 0395 0396 0397 0398 0399 
0401 0402 0403 0404 0405 0406 0407 0408 0409 0410 0411 0412 0413 0414 0415 
0417 0418 0419 0420 0421 0422 0423 0424 0425 0426 0427 0428 0429 0430 0431 
0433 0434 0435 0436 0437 0438 0439 0440 0441 0442 0443 0444 0445 0446 0447 


0449 0450 0451 0452 0453 0454 0455 0456 0457 0458 0459 0460 0461 0462 0463 
0465 0466 0467 0468 0469 0470 0471 0472 0473 0474 0475 0476 0477 0478 0479 
0481 0482 0483 0484 0485 0486 0487 0488 0489 0490 0491 0492 0493 0494 0495 
0497 0498 0499 0500 0501 0502 0503 0504 0505 0506 0507 0508 0509 0510 0511 


0513 0514 0515 0516 0517 0518 0519 06520 0521 0522 0523 0624 0525 0526 0527 
0529 0530 0531 0532 0533 0534 0535 0536 0537 0538 0539 0540 0541 0542 0543 
0545 0546 0547 0548 0549 0550 0551 0552 0553 0554 0555 0556 0557 0558 0559 
0561 0562 0563 0564 0565 0566 0567 0568 0569 0570 0571 0572 0573 0574 0575 


0577 0578 0579 0580 0581 0682 0583 0584 0585 0586 0587 0588 0589 0590 0591 
0593 0594 0595 0596 0597 0598 0599 0600 0601 0602 0603 0604 0605 0606 0607 
0609 0610 0611 0612 0613 0614 0615 0616 0617 0618 0169 0620 0621 0622 0623 
0625 0626 0627 0628 0269 0630 0631 0632 0633 0634 0635 0636 0637 0638 0639 


0641 0642 0643 0644 0645 0646 0647 0648 0649 0650 0651 0652 0653 0654 0655 
0657 0658 0659 0660 0661 0662 0663 0664 0665 0666 0667 0668 0669 0670 0671 
0673 0674 0675 0676 0677 0678 0679 0680 0681 0682 0683 0684 0685 0686 0687 
0689 0690 0691 0692 0693 0694 0695 0696 0697 0698 0699 0700 0701 0702 90703 


0705 0706 0707 0708 0709 O710 0711 +0712 O713 0714 ~O715 0716 O717 0718 0719 
0721 0722 0723 0724 O725 0726 0727 0728 0729 0730 0731 0732 0733 0734 0735 
0737. 0738 0739 0740 0741 0742 0743 0744 0745 0746 0747 0748 0749 0750 0Q751 
0753 0754 0755 0756 0757 0758 0759 O760 0761 0762 0763 0764 0765 0766 0767 


0769 0770 0771 0772 O773 0774 +0775 O776 0777 0778 0779 0780 0781 0782 0783 
0785 0786 0787 0788 0789 0790 0791 0792 0793 0794 0795 0796 0797 0798 0799 
0801 0802 0803 0804 0805 0806 0807 0808 0809 0810 0811 0812 0813 0814 0815 
0817 0818 0819 0820 0821 0822 0823 0824 0825 0826 0827 0828 0829 0830 £0831 


0833 0834 0835 0836 0837 0838 0839 0840 0841 0842 0843 0844 0845 0846 0847 
0849 0850 0851 0852 0853 0854 0855 0856 0857 0858 0859 0860 0861 0862 0863 
0865 0866 0867 0868 0869 0870 0871 0872 0873 0874 0875 0876 0877 0878 0879 
0881 0882 0883 0884 0885 0886 0887 0888 0889 0890 0891 0892 0893 0894 0895 


0897. 0898 0899 0900 0901 0902 0903 0904 0905 0906 0907 0908 0909 0910 0911 
0913 0914 0915 0916 0917 0918 0919 0920 0921 0922 0923 0924 0925 0926 0927 
0929 0930 0931 0932 0933 0934 0935 0936 0937 0938 0939 0940 0941 0942 0943 
0945 0946 0947 0948 0949 0950 0951 0952 0953 0954 0955 0956 0957 0958 0959 


0961 0962 0963 0964 0965 0966 0967 0968 0969 0970 0971 0972 0973 0974 0975 
0977 0978 0979 oO980 0981 0982 0983 0984 0985 0986 0987 0988 0989 0990 0991 
0993 0994 0995 0996 0997 0998 0999 1000 1001 1002 1003 1004 1005 1006 1007 
1009 1010 1011 1012 1013 1014 1015 1016 1017 1018 1019 1020 1021 1022 1023 





Figure A-2 (Part 1 of 4). Hexadecimal/decimal conversion table 


Decimal/Binary/Hexadecimal Conversions A-7 


x = 0 1 2 3 4 5 6 7 8 9 A B Cc D E F 


1024 1025 1026 1027 1028 1029 1030 1031 1032 1033 1034 1035 1036 1037 1038 1039 
1040 1041 1042 1043 1044 1045 1046 1047 1048 1049 1050 1051 1052 1053 1054 #1055 
1056 1057 1058 1059 1060 1061 1062 1063 1064 ##+1065 41066 1067 4=+1068 #41069 1070 1071 
1072 1073 1074 1075 1076 1077 1078 1079 1080 1081 1082 1083 1084 1085 #1086 # £1087 


1088 1089 1090 1091 1092 1093 1094 1095 1096 1097 1098 1099 1100 1101 1102 1103 
1104 1105 1106 1107 1108 $1109 1110 14117 #2©.11112 1113 1114 1115 1116 1117 £42=.1118 1119 
1120) 1121) «©1122 «©1123 1124 1125 1126 1127 1128 1129 1130 1131 1132 1133 1134 1135 
1136 «#1137 «©1138 «©1139 «61140 11417 1142 1143 1144 1145 1146 1147 #1148 1149 1150 1151 


1152) 1153 1154 1155 1156 1157 1158 1159 1160 1161 1162 1163 41164 #1165 1166 # 1167 
1168 1169 1170 1171 #1172 1173 1174 1175 1176 «©1177 «©1178 1179 1180 1181 1182 1183 
1184 1185 1186 1187 1188 1189 1190 1191 1192 1193 1194 1195 1196 1197 1198 1199 
1200 1201 1202 1203 1204 +1205 1206 1207 1208 +1209 «#1210 1211 1212 1213 1214 1215 


1216 1217) 1218 1219 1220 1221 1222 1223 «1224 1225 1226 1227) 1228 1229 1230 1231 
1232 1233 1234 1235 1236 1237 1238 1239 1240 1241 1242 1243 1244 1245 1246 1247 
1248 1249 1250 1251 1252 1253 1254 41255 1256 1257 1258 1259 1260 1261 1262 1263 
1264 1265 1266 1267 1268 $1269 1270 1271 1272 1273 «©1274 «1275 1276 1277 ©1278 #81279 


1280 1281 1282 1283 1284 1285 1286 1287 21288 1289 1290 1291 1292 1293 1294 1295 
1296 1297 1298 1299 1300 1301 1302 1303 1304 1305 1306 1307 1308 #1309 1310 1311 
1312 1313 1314 1315 1316 1317 1318 1319 1320 1321 1322 1323 1324 1325 1326 1327 
1328 1329 1330 1331 1332 1333 1334 1335 «©1336 0) «©1337 1338 1339 1340 1341 1342 1343 


1344 1345 1346 1347 1348 1349 1350 1351 1352 1353 1354 1355 1356 1357 1358 1359 
1360 1361 1362 1363 1364 1365 1366 1367 1368 1369 1370 1371 1372 1373 1374 #81375 
1376 1377 1378 1379 1380 1381 1382 1383 1384 1385 1386 1387 1388 1389 1390 8 1391 
1392 1393 1394 1395 1396 1397 1398 1399 1400 1401 1402 1403 1404 1405 1406 1407 


1408 1409 1410 1411 1412 1413 1414 1415 1416 1417 1418 1419 1420 1421 1422 1423 
1424 1425 1426 1427 1428 1429 1430 1431 1432 1433 1434 1435 1436 1437 1438 1439 
1440 1441 1442 1443 1444 1445 1446 1447 1448 1449 1450 1451 1452 1453 1454 1455 
1456 1457 1458 1459 1460 1461 1462 1463 1464 1465 1466 1467 1468 1469 1470 1471 


1472 1473 1474 1475 1476 1477 1478 1479 1480 1481 1482 1483 1484 1485 1486 1487 
1488 1489 1490 1491 1492 1493 1494 1495 1496 1497 1498 1499 1500 1501 1502 1503 
1504 1505 1506 1507 1508 1509 1510 1511 1512 1513 1514 #1515 1516 1517 1518 1519 
1520 1521 1522 1523 1524 1525 1526 1527 1528 1529 1530 1531 1532 1533 1534 1535 


1536 1537 1538 1539 1540 1541 1542 1543 1544 1545 1546 1547 1548 1549 1550 1551 
1552. 1553 1554 1555 1556 1557 1558 1559 1560 1561 1562 1563 1564 1565 1566 1567 
1568 1569 1570 1571 1572 1573 1574 1575 1576 1577 1578 1579 1580 1581 1582 1583 
1584 1585 1586 1587 1588 1589 1590 1591 1592 1593 1594 1595 1596 1597 1598 1599 


1600 1601 1602 1603 1604 1605 1606 1607 1608 1609 1610 1611 1612 1613 1614 1615 
1616 1617 1618 1619 1620 1621 1622 1623 1624 1625 1626 1627 1628 1629 1630 1631 
1632. 1633 1634 1635 1636 1637 1638 1639 1640 1641 1642 1643 1644 1645 1646 1647 
1648 1649 1650 1651 1652 1653 1654 1655 1656 1657 1658 1659 1660 1661 1662 1663 


1664 1665 1666 1667 1668 1699 1670 1671 1672 1673 1674 1675 1676 1677 4.1678 1679 
1680 1681 1682 1683 1684 1685 1686 1687 1688 1689 1690 1691 1692 1693 1694 1695 
1696 1697 1698 1699 1700 1701 1702 1703 1704 +1705 1706 1707 #1708 #$1709 «#1710 = 1711 
1712, 1713) «1714 «©1718 ) =61716 = 1717) 1718) 1719) 1720, 1721) 1722) 1723) 1724) = 1725) 1726—S: 11727 


1728) «©1729, 17380) 1731) 17382) 1733) s17384)0S 17385) 17362-1737): 1738)=— 17389): 1740)—S «11741 -‘1742~—Ss« 1743 
1744 1745 1746 1747 1748 1749 1750 1751 1752 1753 1754 +1755 1756 1757 4.1758 #1759 
1760 1761 1762 1763 1764 «#11765 1766 1767 +1768 #+1769 1770 1771 «#1772 1773 «©1774 1775 
1776 «#1777 «©1778 1779 1780 1781 1782 1783 1784 1785 1786 1787 «211788 #41789 «#1790 += 1791 


1792 1793 1794 1795 1796 1797 1798 1799 1800 1801 1802 1803 1804 1805 1806 1807 
1808 1809 1810 1811 1812 1813 1814 1815 1816 1817 1818 1819 1820 1821 1822 1823 
1824 1825 1826 1827 1828 1829 1830 1831 1832 1833 1834 1835 1836 1837 1838 1839 
1840 1841 1842 1843 1844 1845 1846 1847 1848 1849 1850 1851 1852 1853 1854 1855 


1856 1857 1858 1859 1860 1861 1862 1863 1864 1865 1866 1867 1868 1869 1870 1871 
1872 1873 1874 1875 1876 1877 1878 1879 1880 1881 1882 1883 1884 1885 1886 1887 
1888 1889 1890 1891 1892 1893 1894 1895 1896 1897 1898 1899 1900 1901 1902 1903 
1904 1905 1906 1907 1908 1909 1910 1911 1912 1913 1914 1915 1916 1917 1918 1919 


1920 1921 1922 1923 1924 1925 1926 1927 1928 1929 1930 1931 1932 1933 1934 1935 
1936 1937 1938 1939 1940 1941 1942 1943 1944 1945 1946 1947 1948 1949 1950 1951 
1952 1953 1954 1955 1956 1957 1958 1959 1960 1961 1962 1963 1964 1965 1966 1976 
1968 1969 1970 1971 1972 1973 1974 1975 1976 1977 1978 1979 1980 1981 1982 1983 


1984 1985 1986 1987 1988 1989 1990 1991 1992 1993 1994 1995 1996 1997 1998 1999 
2000 2001 2002 2003 2004 +2005 2006 2007 4=+.2008 2009 2010 2011 #2012 2013 2014 # «2015 
2016 2017) 2018 2019 2020 2021 2022 2023 2024 +2025 2026 2027 #£=«°.2028 2029. 2030 # £2031 
2032 2033 2034 2035 2036 2037 £2038 2039 2040 2041 2042 +2043 2044 +2045 2046 2047 





Figure A-2 (Part 2 of 4). Hexadecimal/decimal conversion table 


A-8 SC34-0074 


1 2 3 4 5 6 7 8 9 A B C D E F 


2049. 2050 2051 2052 2053 2054 2055 2056 2057 2058 2059 2060 2061 2062 2063 
2065 2066 2067 2068 2069 2070 2071 4.2072 2073 2074 #=+.2075 2076 2077 4.2078 # £2079 
2081 2082 2083 2084 2085 2086 2087 2088 2089 2090 2091 2092 2093 2094 2095 
2097. 2098 2099 2100 2101 2102 2103 2104 +2105 2106 2107 £=°.2108 2109 2110 2111 


2113 2114 «=©2115 82116 2117 2118 2119 2120 2121 2122 2123 2124 2125 2126 2127 
2129) «= 2130) «2131 2132) 2133) 2134) = 21385) Ss 21386) 2137) 21388) = 2139) 2140) Ss 2141 = 2142) 2143 
2145 2146 2147 2148 2149 2150 2151 2152 2153 2154 2155 2156 2157 2158 2159 
2161 2162 2163 2164 2165 2166 2167 2168 2169 2170 2171 £42.2172 2173 2174 = # 2175 


2177) 2178) =—-2179- 2180). 2181s 2182) 2183) 2184 2185) = - 2186 )3=—ss 2187)—Ss- 2188 )3=—s 2189S - 2190S 2191 
2193. 2194 2195 2196 2197 2198 2199 2200 2201 2202 2203 2204 +2205 #2206 #2207 
2209 «2210 2211 2212 2213 2214 2215 2216 2217 2218 2219 2220 2221 2222 2223 
2225 2226 2227) 2228 2229 2230 2231 2232 2233 2234 2235 2236 2237 2238 8=©2239 


2241 #2242 2243 2244 2245 2246 2247 «2248 §=62249 2250 2251 2252 2253 2254 2255 
2257 3=2258 §=2259 2260 2261 2262 2263 2264 2265 2266 2267 £2268 =%.2269 2270 2271 
2273 2274 22765 2276 2277 2278 2279 2280 2281 2282 2283 2284 2285 2286 2287 
2289 2290 2291 2292 2293 2294 2295 2296 2297 2298 2299 2300 2301 2302 2303 


2305 2306 2307 2308 2309 2310 2311 £2312 2313 2314 2315 2316 2317 2318 2319 
2321 2322 2323 2324 2325 2326 2327) 2328 2329 2330 2331 2332 2333 2334 2335 
2337) 2338) = 2339) 2340) 2341) 2342) 2343) 2344) 2345) 2346) 2347) 2348) = 2349) Ss 2350) 2351 
2353 2354 2355 2356 2357 2358 2359 2360 2361 2362 2363 2364 +2365 2366 2367 


2369 = 2370)» =2371 2372 2373 «2374 «2375 2376 2377 2378 «2379 2380 2381 2382 2383 
2385 2386 2387 2388 2389 2390 2391 2392 2393 2394 2395 2396 2397 2398 2399 
2401 2402 2403 2404 2405 2406 2407 2408 2409 2410 2411 2412 2413 2414 2415 
2417) 2418 = 2419 2420 2421 2422 2423 2424 2425 2426 2427 2428 2429 2430 2431 


2433 2434 82435 2436 2437 2438 2439 2440 2441 2442 2443 2444 #2445 2446 £2447 
2449 2450 2451 2452 2453 2454 2455 2456 2457 2458 2459 2460 2471 2462 2463 
2465 2466 2467 2468 2469 2470 2471 2472 2473 2474 #+.(2475 2476 2477 2478 2479 
2481 2482 2483 2484 2485 2486 2487 2488 2489 2490 2491 2492 2493 2494 2495 


2497 2498 2499 2500 2501 2502 2503 2504 2505 2506 2507 2508 2509 2510 2511 
2513 2514 2515 2516 2517 2518 2519 2520 2521 2522 2523 2524 2525 2526 #2527 
2529 +2530 2531 2532 2533 2534 2535 2536 2537 2538 2539 2540 2541 2542 2543 
2545 2546 2547 2548 2549 2550 2551 2552 2553 2554 2555 2556 2557 2558 2559 


2561 2562 2563 2564 2565 2566 2567 2568 2569 2570 2571 2572 2573 2574 2575 
2577) «2578 §=2579 2580 2581 2582 2583 2584 2585 2586 2587 2588 2589 2590 2591 
2593 2594 2595 2596 2597 2598 2599 2600 2601 2602 2603 2604 2605 2606 £2607 
2609 2610 2611 2612 2613 2614 2615 2616 2617 2618 2619 2620 2621 2622 2623 


2625 2626 2627 2628 2629 2630 2631 2632 2633 2634 2635 2636 2637 2638 $2639 
2641 2642 2643 2644 2645 2646 2647 2648 2649 2650 2651 2652 2653 2654 2655 
2657 2658 2659 2660 2661 2662 2663 2664 2665 2666 2667 2668 2699 2670 2671 
2673 2674 2675 2676 2677 2678 2679 2680 2681 2682 2683 2684 2685 2686 2687 


2689 2690 2691 2692 2693 2694 2695 2696 2697 2698 2699 2700 2701 2702 2703 
2705 2706 2707 2708 2709 2710 2711 £42712 2713 2714 +2715 2716 2717 4.2718 2719 
2721 2722 2723 «2724 =2725 82726) =©2727)= «62728 )3=— 2729) 27380) 2731S 2732) 2733) 2734 = 2735 
2737) = =—-2738) = 2739) 2740) 2741-2742) 2743) 2744) = 2745) 2746) 2747) 2748) = 2749) 2750) 2751 


2753 2754 2755 2756 2757 2758 2759 2760 2761 2762 2763 2764 +2765 2766 # 2767 
2769) 2770) 2771 2772 = =2773 = «62774 ) =—2775)—S 2776S 2777) 2778) )—S 2779) 2780S 2781S 2782 = 2783 
2785 2786 2787 2788 2789 2790 2791 2792 2793 2794 2795 2796 2797 2798 2799 
2801 2802 2803 2804 2805 2806 2807 2808 2809 2810 2811 2812 2813 2814 2815 


2817 2818 2819 2820 2821 2822 2823 2824 2825 2826 2827 2828 2829 2830 2831 
2833 2834 2835 2836 2837 2838 2839 2840 2841 2842 2843 2844 2845 2846 2847 
2849 2850 2851 2852 2853 2854 2855 2856 2857 2858 2859 2860 2861 2862 2863 
2865 2866 2867 2868 2869 2870 2871 2872 2873 2874 2875 2876 2877 2878 2879 


2881 2882 2883 2884 2885 2886 2887 2888 2889 2890 2891 2892 2893 2894 2895 
2897. 2898 2899 2900 2901 2902 2903 2904 2905 2906 2907 2908 2909 2910 2911 
2913 2914 2915 2916 2917 2918 2919 2920 2921 2922 2923 2924 2925 2926 2927 
2929. 2930 2931 2932 2933 2934 2935 2936 2937 2938 2939 2940 2941 2942 2943 


2945 2946 2947 2948 2949 2950 2951 2952 2953 2954 2955 2956 2957 2958 2959 
2961 2962 2963 2964 2965 2966 2967 2968 2969 2970 2971 2972 2973 2974 2975 
2977. +2978 2979 2980 2981 2982 2983 2984 2985 2986 2987 2988 2989 2990 2991 
2993 2994 2995 2°96 2997 2998 2999 3000 3001 3002 3003 3004 3005 3006 3007 


3009 3010 3011 3012 3013 3014 3015 3016 3017 3018 3019 3020 3021 3022 3023 
3025 3026 3027 3028 3029 3030 3031 3032 3033 3034 3035 3036 3037 3038 3039 
3041 3042 3043 3044 3045 3046 3047 3048 3049 3050 3051 3052 3053 3054 3055 
3057 3058 3059 3060 3061 3062 3063 3064 3065 3066 3067 3068 3069: 3070 3071 





Figure A-2 (Part 3 of 4). Hexadecimal/decimal conversion table 


Decimal/Binary/Hexadecimal Conversions A-9 
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2 


3074 
3090 
3106 
3122 


3138 
3154 
3170 
3186 


3202 
3218 
3234 
3250 


3266 
3282 
3298 
3314 


3330 
3346 
3362 
3378 


3394 
3410 
3426 
3442 


3458 
3474 
3490 
3506 


3522 
3538 
3554 
3570 


3586 
3602 
3618 
3634 


3650 
3666 
3682 
3698 


3714 
3730 
3746 
3762 


3778 
3794 
3810 
3826 


3842 
3858 
3874 
3890 


3906 
3922 
3938 
3954 


3970 
3986 
4002 
4018 


4034 
4050 
4066 
4082 


3 


3075 


3107 
3123 


3139 
3155 
3171 
3187 


3203 
3219 
3235 
3251 


3267 
3283 


3299 


3315 


3331 
3347 
3363 
3379 


3395 
3411 
3427 
3443 


3459 
3475 
3491 
3507 


3523 
3539 
3555 
3571 


3587 
3603 
3619 
3635 


3651 
3667 
3683 
3699 


3715 
3731 
3747 
3763 


3779 
3795 
3811 
3827 


3843 
3859 
3875 
3891 


3907 
3923 
3939 
3955 


3971 
3987 
4003 
4019 


4035 
4051 
4067 
4083 


4 


3076 
3092 
3108 
3124 


3140 
3156 
3172 
3188 


3204 
3220 
3236 
3252 


3268 
3284 
3300 
3316 


3332 
3348 
3364 
3380 


3396 
3412 
3428 
3444 


3460 
3476 
3492 
3508 


3524 
3540 
3556 
3572 


3588 
3604 
3620 
3636 


3652 
3668 
3684 
3700 


3716 
3732 
3748 
3764 


3780 
3796 
3812 
3828 


3844 
3860 
3876 
3892 


3908 
3924 
3940 
3956 


3972 
3988 
4004 
4020 


4036 
4052 
4068 
4084 


5 


3077 
3093 
3109 
3125 


3141 
3157 
3173 
3189 


3205 
3221 
3237 
3253 


3269 
3285 
3301 
3317 


3333 
3349 
3365 
3381 


3397 
3413 
3429 
3445 


3461 
3477 
3493 
3509 


3525 
3541 
3557 
3573 


3589 
3605 
3621 
3637 


3653 
3669 
3685 
3701 


3717 
3733 
3749 
3765 


3781 
3797 
3813 
3829 


3845 
3861 
3877 
3893 


3909 
3925 
3941 
3957 


3973 
3989 
4005 
4021 


4037 
4053 
4069 
4085 


6 


3078 
3094 
3110 
3126 


3142 
3158 
3174 
3190 


3206 
3222 
3238 
3254 


3270 
3286 
3302 
3318 


3334 
3350 
3366 
3382 


3398 
3414 
3430 
3446 


3462 
3478 
3494 
3510 


3526 
3542 
3558 
3574 


3590 
3606 
3622 
3638 


3654 
3670 
3686 
3702 


3718 
3734 
3550 
3766 


3782 
3798 
3814 
3830 


3846 
3862 
3878 
3894 


3910 
3926 
3942 
3958 


3974 
3990 
4006 
4022 


4038 
4054 
4070 
4086 


7 


3079 
3095 
3111 
3127 


3143 
3159 
3175 
3191 


3207 
3223 
3239 
3255 


3271 
3287 
3303 
3319 


3335 
3351 
3367 
3383 


3399 
3415 
3431 
3447 


3463 
3479 
3495 
3511 


3527 
3543 
3559 
3575 


3591 
3607 
3623 
3639 


3655 
3671 
3687 
3703 


3719 
3735 
3751 
3767 


3783 
3799 
3815 
3831 


3847 
3863 
3879 
3895 


3911 
3927 
3943 
3959 


3975 
3991 
4007 
4023 


4039 
4055 
4071 
4087 


8 


3080 
3096 
3112 
3128 


3144 
3160 
3176 
3192 


3208 
3224 
3240 
3256 


3272 
3288 
3304 
3320 


3336 
3352 
3368 
3384 


3400 
3416 
3432 
3448 


3464 
3480 
3496 
3512 


3528 
3544 
3560 
3576 


3592 
3608 
3624 
3640 


3656 
3672 
3688 
3704 


3720 
3736 
3752 
3768 


3784 
3800 
3816 
3832 


3848 
3864 
3880 
3896 


3912 
3928 
3944 
3960 


3976 
3992 
4008 
4024 


4040 
4056 
4072 
4088 


9 


3081 
3097 
3113 
3129 


3145 
3161 
3177 
3193 


3209 
3225 
3241 
3257 


3273 
3289 
3305 
3321 


3337 
3353 
3369 
3385 


3401 
3417 
3433 
3449 


3465 
3481 
3497 
3513 


3529 
3545 
3561 
3577 


3593 
3609 
3625 
3641 


3657 
3673 
3689 
3705 


3721 
3737 
3753 
3769 


3785 
3801 
3817 
3833 


3849 
3865 
388 1 
3897 


3913 
3929 
3945 
3961 


3977 
3993 
4009 
4025 


4041 
4057 
4073 
4089 


A 


3082 
3098 
3114 
3130 


3146 
3162 
3178 
3194 


3210 
3226 
3242 
3258 


3274 
3290 
3306 
3322 


3338 
3354 
3370 
3386 


3402 
3418 
3434 
3450 


3466 
3482 
3498 
3514 


3530 
3546 
3562 
3578 


3594 
3610 
3626 
3642 


3658 
3674 
3690 
3706 


3722 
3738 
3754 
3770 


3786 
3802 
3818 
3834 


3850 
3866 
3882 
3898 


3914 
3930 
3946 
3962 


3978 
3994 
4010 
4026 


4042 
4058 
4074 
4090 


B 


3083 
3099 
3115 
3131 


3147 
3163 
3179 
3195 


3211 
3227 
3243 
3259 


3275 
3291 
3307 
3323 


3339 
3355 
3371 
3387 


3403 
3419 
3435 
3451 


3467 
3483 
3499 
3515 


3531 
3547 
3563 
3579 


3595 
3611 
3627 
3643 


3659 
3675 
3691 
3707 


3723 
3739 
3755 
3771 


3787 
3803 
3819 
3835 


3851 
3867 
3883 
3899 


3915 
3931 
3947 
3963 


3979 
3995 
4011 
4027 


4043 
4059 
4075 
4091 


Figure A-2 (Part 4 of 4). Hexadecimal/decimal conversion table 


C 


3084 
3100 
3116 
3132 


3148 
3164 
3180 
3196 


3212 
3228 
3244 
3260 


3276 
3292 
3308 
3324 


3340 
3356 
3372 
3388 


3404 
3420 
3436 
3452 


3468 
3484 
3500 
3516 


3532 
3548 
3564 
3580 


3596 
3612 
3628 
3644 


3660 
3676 
3692 
3708 


3724 
3740 
3756 
3772 


3788 


3820 
3836 


3852 


3884 
3900 


3916 
3932 
3948 
3964 


3980 
3996 
4012 
4028 


4044 
4060 
4076 
4092 


D 


3085 
3101 
3117 
3133 


3149 
3165 
3181 
3197 


3213 
3229 
3245 
3261 


3277 
3293 
3309 
3325 


3341 
3357 
3373 
3389 


3405 
3421 
3437 
3453 


3469 
3485 
3501 
3517 


3533 
3549 
3565 
358 1 


3597 
3613 
3629 
3645 


3661 
3677 
3693 
3709 


3725 
3741 
3757 
3773 


3789 


3821 
3837 


3853 
3869 
3885 
3901 


3917 
3933 
3949 
3965 


3981 
3997 
4013 
4029 


4045 
4061 
4077 
4093 


E 


3086 
3102 
3118 
3134 


3150 
3166 
3182 
3198 


3214 
3230 
3246 
3262 


3278 
3294 
3310 
3326 


3342 
3358 
3374 
3390 


3406 
3422 


3454 


3470 
3486 
3502 
3518 


3534 
3550 
3566 
3582 


3598 
3614 
3630 
3646 


3662 
3678 
3694 
3710 


3726 
3742 
3758 
3774 


3790 


3822 
3838 


3854 
3870 
3886 
3902 


3918 


3934 
3950 
3966 


3982 
3998 
4014 
4030 


4046 
4062 
4078 
4094 


F 


3087 
3103 
3119 
3135 


3151 
3167 
3183 
3199 


3215 
3231 
3247 
3263 


3279 
3295 
3311 
3327 


3343 
3359 
3375 
3391 


3407 
3423 
3439 
3455 


3471 
3487 
3503 
3519 


3535 
3551 
3567 
3583 


3599 
3615 
3631 
3647 


3663 
3679 
3695 
3711 


3727 
3743 
3759 
3775 


3791 
3807 
3823 
3839 


3855 
3871 


3903 


3919 
3935 
395 1 
3967 


3983 
3999 
4015 
4031 


4047 
4063 
4079 
4095 


Appendix B. American National Standard Code 


for Information Interchange (ASCII) 














Bit position 


B-i 


American National Standard Code for Information Interchange (ASCII) 
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Appendix C. Perforated Tape Transmission Code/Extended 
Binary Coded Decimal (PTTC/EBCD) 


it 
Positions 


(4.2.1.0) 


et ft fost fet | | 
ee det fet tf ee el 
NLsee LF see NLsee 
note % note note 
2 1 2 
Down- Up- W Down 
shift shift shift 
Back f Back c 
space EOB space 
melo | f>] | | { foelo] 
en Lower Case eer Upper Case ——— 


PP PELEEE] tan 9 eo 
or 1 (upper case) inserted on receive 
See ar per operations. Insertion/deletion is 
erminal code 
erformed by equipment 
ps jetatets{e]:| ec} mma pera ae 


Notes: 


Ao 
© < 
za 
3 x > 
A 


3 
fe) 
pass 
@ 


ram 
# 
© t 
As 
mnie 
Up- 
5 


m 
oO 
=] 


{3 
7 


m 





stert | 8 | A] 8] 4 | 2 | 1] © [stop ADS oll Sa 1. Line feed (LF) performs the indexing 
function 
2. New line (NL) performs the carrier 
C is odd parity check bit for S, B, A, 8, 4, ZN return and line feed function 
On receiving operation, start and stop bits are deleted. 3. Similar terms: 
On transmitting operation, start and stop bits are added. Apwinenite= lowercase 


upshift = upper case 


Perforated Tape Transmission Code/Extended Binary Coded Decimal (PTTC/EBCD) C-1 


C-2. SC34-0074 


Appendix D, Pseudobinary PTTC/EBCD Conversion 


If a host computer transmits or receives binary data, it must be in EBCDIC 
pseudobinary code. Also, two down shift characters (X‘7C7C’) must immediately 
precede the binary data. These two characters identify the data as binary. 

Figure D-1 is a conversion table for pseudobinary data. Use the portion of the table that 
corresponds to your access method. 


| Character to transmit to transmit Transmitted PTTC/EBCD Character 


| EBCDIC lowercase characters* | lowercase | EBCDIC lowercase characters* | | Hexadecimal characters** | characters* * 
Hexadecimal Binary 
Non-end-of-word End-of-word Non-end-of-word End-of-word 
character character character character 











*This column contains the graphic representation of the pseudobinary 
characters that must be passed to host telecommunications access 
methods that perform EBCDIC to PTTC/EBCD conversion. 


**This column contains the pseudobinary hexadecimal data that must 
be passed to the host access methods that do not convert data. 


Figure D-1, Pseudobinary conversion table 


Pseudobinary PTTC/EBCD Conversion  D-1 


D-2 
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Convert each hexadecimal digit starting from the low-order 
position of the word (right to left). Each digit has 
corresponding hexadecimal values in the table. If the digit 
is the most significant digit in the high order position.of 
the word (that is, only zeros precede it to the left), then 
take its corresponding pseudobinary value from the “last” 
column in the table. If the digit is not the high-order 
significant digit, take its corresponding value from the 
“first” column in the table. Place the pseudobinary values 
in the output record from left to right, or in the reverse 
order of the unconverted digits. Do not convert zeros to 
the left of the most significant digit. For example, you 
would convert a word containing X‘O5F2’ to X‘F486A3’. 


Hex 
digit 


T™MOO WHRPOM Noun WN O 


First 


F8 
F2 
F4 
F6 


A8& 
A2 
A4 
AG 


98 
92 
94 
96 


88 
82 
84 
86 


Last 


FQ 
F3 
F5 
&/ 


AQ 
A3 
Ad 
A7 


99 
93 
95 
97 


89 
83 
85 
87 


e If the host Telecommunications Access Method performs an EBCDIC to PTTC/EBCD 
conversion, pseudobinary data must be passed to this access method in the EBCDIC 


lowercase form shown in Figure D-1. 


e If the access method only performs data transfer, pseudobinary data must be passed to 
the access method in the hexadecimal form shown in Figure D-1.For both methods, an 
end-of-word indicator is required. The value in parentheses (see Figure D-1) represents 
the most significant four bits of a word. These bits contain the pseudobinary value of 


the last hexadecimal character in the word plus the end-of-word bit. 


The conversion to pseudobinary must be performed on a word from right to left. To 
illustrate this conversion process, assume binary data, equivalent to hexadecimal 8910, 


is transmitted from System/7 to a host system. Using Figure D-1, 8910 becomes: 


8 or hex 10 
2 or hex 04 — 


k or hex 45 
r or hex 52 (end-of-word indicator) 


These 4 characters 82kr are then transmitted serially (hex 10044552) in PTTC/EBCD. 
When the message is received by the host system, a program must strip out the 4 
significant data bits (BA42). This procedure is illustrated below. 


SBA8421C 
End-of-word bit 


PTTC/EBCD 0O{10]1/00]10 0/10} 0]01]01 0700}0/01;00 0/00] 1/00/00 


Le Pseudo- 10! [oo 10} |01 oo} |o1 00] loo 
Sate binary 
PTTC/EBCD 
‘caine ey Nii plata ee re 
Hexadecimal 8 9 1 0 


Transmitting Leading Zeros 


Leading hexadecimal zeros need not be transmitted, thus reducing the number of trans- 
mitted bits. For example, assume hexadecimal 0018 is to be transmitted. Using Figure 
D-1 

8 becomes q or hex 51 

1 becomes 3 or hex 07 (end-of-word indicator) 


0018 is then transmitted serially in PTTC/EBCD code as g3 (hex 5107). The following 
process occurs on the receiving end. 


1. Work area is cleared. 000 0 


2. qis received and is 
right-adjusted in 


work area. 0 0 0(8) 


3. 3is received and is 
right-adjusted in work 


area. 0 0 


Since 3 carries the 
end-of-word indicator, 
transmission for hex 
0018 is complete. 


4, Processing continues. 


Pseudobinary PTTC/EBCD Conversion )p-3 
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Conversion examples 


Word EBCDIC lowercase PTTC/EBCD Hex 
1A37 w6m3 2C0D4907 
04FC hfz 706D32 


Relationships of various codes 


Figure D-2 shows the relationships of the various code formats. The only meaningful bits 
transmitted are B, A, 4, and 2. 










Hexadecimal 
bit positions 


Binary terminal| S 
code structure 


Pseudo binary 
conversion bits 


Pseudo data 
transmission 
format 












Example: 
transmitted 
hex 2 


Legend: 
D = data bits 
E =  end-of-word indicator 


— = bits required for transmission, but 
aren’t used to represent transmitted 
binary bits - 


Figure D-2. Relationship of pseudobinary PTTC/EBCD to hexadecimal and binary PTTC/EBCD 


TITLE 
EJECT 
PRINT 
SPACE 


MACRO 


GBL 
LCL 
ACTR 


AIF 
AGG 
SETA 
SETB 
SETC 
ANOP 
MEXIT 
MNOTE 


MEND 


ENTRY 
WXTRN 
EXTRN 
DSECT 


START 
CSECT 


EQU 
EQUR 
DC 

DS 

- ORG 
USING 
DROP 


END 


any place 


before first CSECT 
after macro prototype 


follows globals 
follows locals 


within macro definitions, anywhere 
between ACTR and MEND 


must be last statement of 
a macro definition 


anywhere after macro definitions 


after macro definitions 


after macro definitions 

if there is a START or CSECT 
statement, anywhere after it. If 
there is no START or CSECT, 


any of these instructions can 
begin a nameless CSECT. 


must be last statement of an assembly 


Priority List for Assembler Instructions 


Appendix E. Priority List for Assembler Instructions 
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Appendix F. Summary of Constants 











































Implied Number of 
length constants per | Exponent Truncation/ | Padding 
(bytes) operand range Scale range padding side character 





Length 
modifier 
range 
(bytes) Specified by 
as (2) 1-256 characters 
needed (1) 
as (2) 1-256 hexadecimal left 
needed Q) digits 
as (2) 1—256 binary 
needed digits 
decimal several -85 to i oe left 9 
digits +75 
ie 
decimal several -85 to right 
digits +75 
any several left 
expression 





C 
: 











relocatable several assembled 
symbol as X‘0000’ 
relocatable several assembled 
symbol as X‘0000” 
decimal several -85 to 
digits +75 
decimal several -85 to -187 to 
digits +75 
decimal several -85 to 
digits +75 


Q) In DS assembler instructions, C, S, P, and X type constants can have length specification to 65535. 





(2) In DS assembler instruction types C, S, P, X, and B, the implied length is 1 when a length modifier and a constant value 
are not specified. 


Summary of Constants  F-1 
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Appendix G. Macro Language Summary 


The 4 figures in this appendix summarize the macro language described in Chapter 6 
of this publication. : 

Figure G-1 is a summary of the expressions that may be used in macro instruction 
statements. 

Figure G-2 indicates which macro language elements may be used in the name and 
operand entries of each statement. 

Figure G-3 is a summary of the attributes that may be used in each expression. 

Figure G-4 is a summary of the variable symbols that may be used in each expression. 


Expression Arithmetic expressions Character expressions Logical expressions 
1 


May contain . Self-defining terms . Any combination of . SETB symbols 
. Count and number attributes characters enclosed in . Arithmetic relations! 
. SETA and SETB symbols apostrophes . Character relations? 
. SETC symbols whose value . Any variable symbol . SETA expression* 
is 1-8 decimal digits enclosed in apostrophes 
. Symbolic parameters if the . A concatenation of 
corresponding operand is variable symbols and 
a self-defining term other characters enclosed 
. &SYSLIST (n) if the cor- in apostrophes 
responding operand is a . A request for a type 
self-defining term attribute 
. &SYSLIST (n,m) if the 
corresponding operand 
is a self-defining term 
» &SYSNDX 
. &SYSPARM whose value is 
1-8 decimal digits 


Operators are +,-, *, and / concatenation, with a : AND, OR, and NOT 
parentheses permitted period (.) parentheses permitted 

Range of -23 1 to +23! -1 0 through 127 characters 0 (false) or 

values 1 (true) 


May be . SETA operands 1. SETC operands? 1. SETB operands 
used in . Arithmetic relations 2. Character relations? 2. AIF operands 

. Subscripted SET symbols 3. SETA operands (if 

. A subscript of &SYSLIST 1-8 decimal digits) 

. Substring notation 

. Sublist notations 

. SETC operands 

. ACTR operands 
1 


An arithmetic relation consists of two arithmetic expressions related by the operator GT, LT, EQ, NE, GE, or LE. 
A character relation consists of two character expressions related by the operator GT, LT, EQ, NE, GE, or LE. The 
type attribute notation and the substring notation may also be used in character relations. The maximum size of the 
character expressions that can be compared is 127. characters. If the two character expressions are of unequal size, 
then the smaller one will always compare less than the larger. 
Maximum of eight characters will be assigned. 

‘ The expression must be a valid SETA expression which resolves to 0 or 1. 





Figure G-1. Expressions for conditional assembly 


Macro Language Summary G-l 





Variable Symbols 
Global SET Symbols Local SET Symbols System Variable Symbols 
Symbolic | 7 
Statement | Parameter | SETA SETB SETC SETA SETB SETC &SYSNDX | &SYSLIST | &SYSPARM 


Prototype | Name 
Statement | Operand 
GBLA 


el 
a 
aed 
ucta | 
aerials 
be ee 








Operation 
Operand 


Operand* | Operand’? | Name Operand? | Operand’ | Operand | Operand? | Operand’ 
rand 
SETB Operand* | Operand* | Name Operand* | Operand* | Name Operand* | Operand* | Operand* | Operand* 
Operand Operand 
SETC Operand | Operand*® | Operand® | Name Operand*® | Operand® | Name Operand | Operand Operand 
: Operand Operand 


eS SC GO 

aE] A AT ASEAN EA I SNRRET ANA [A 

ota Eas cde Macanl madi tue ae 

A CC 
ed 


Outer Name Name Name Name Name Name Name 
Macro Operand | Operand |Operand | Operand perand | Operand Operand 






SETA Operand? 






© 
S 
® 


Inner Name Name Name Name Name Name Name Name Name . Name 
Macro Operand |Operand | Operand |Operand |Operand | Operand |QOperand | Operand Operand Operand 


Assembler 
Language 
Statement 


Variable symbols in macro instructions are replaced by their values before processing. 
Only if value is self-defining term. 

Converted to arithmetic +1 or +0. 

Only in arithmetic or character relations. 






Converted to unsigned number. 
Converted to character 1 or 0. 
Only if one to eight decimal digits. 


Figure G-2. (Part 1 of 2). Macro language elements 
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Attributes 





Sequence 
Number symbol 





Statement Count 


MACRO 
Prototype 
Statement 


Name 


Operand 


AIF Operand! Operand? Operand? Name 
Operand 


Operand 


Operand 
Operand? 


Operand Operand 
Name 
Name 
Name 
Name 


Name 


Name 


Assembler Name 
Language 


Statement 


1 Only in character relations. 
2 Only in arithmetic relations. 


Figure G-2. (Part 2 of 2). Macro language elements 


Macro Language Summary G-3 
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May be used wit’ | ‘May be wed in 


Type T’ 1. SETC operand fields 
2. Character relations 


*Note. Thére are definite restrictions in the use of these attributes. Refer to Chapter 6. 





Symbolic parameters, 
&SYSLIST (n), and 
&SYSLIST (n,m) 
inside macro 
definitions 












Symbolic parameters 
corresponding to 
macro instruction 
operands, &SYSLIST, 
and &SYSLIST (n) 
inside macro 
definitions 


Arithmetic expressions 

























Symbolic parameters, 
&SYSLIST, and 
&SYSLIST (n) inside 
macro definitions 


Arithmetic expressions 









Figure G-3. Attributes of macro-instruction operands 


Variable Initialized, Value changed 
symbol Defined by: or Set to: by: May be used in: 


Symbolic! Prototype Corresponding (Constant 1. Arithmetic expressions 
parameter statement macro instruc- throughout if operand is self- 


tion operand definition) defining term 
2. Character expressions 


SETA LCLA or GBLA SETA 1. Arithmetic expressions 
instruction instruction 2. Character expressions 



































SETB LCLB or GBLB SETB 1. Arithmetic expressions 
instruction instruction 2. Character expressions 
3. Logical expressions 
SETC LCLC ro GBLC Null character SETC 1. Arithmetic expressions 


if value is self- 
defining term 
2. Character expressions 


instruction value instruction 


&SYSNDX? The assembler 




















1. Arithmetic expressions 
2. Character expressions 


(Constant 
throughout 
definition; 
unique for 
each macro 
instruction) 


Macro instruc- 
tion index 








&SYSLIST’ The assembler Not applicable Not applicable | - N’ &SYSLIST in 
arithmetic expressions 





























&SYSLIST (n)! The assembler Corresponding (Constant 1. Arithmetic expressions 
&SYSLIST (n,m)! macro instruc- throughout if operand is self- 
tion operand definition) defining term 





. Character expressions 

































1. Arithmetic expressions 
if value is 1-8 decimal 
digits . 

2. Character expressions 


&SYSPARM! Value specified 
in a job control 
statement (null 
character value 


if not specified) 


(Constant 
throughout 
assembly) 


You, in response 
to OPTIONS= 
prompt at the 
operator station 








1 All may only be used in macro definitions. 


Figure G-4. Variable symbols 
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Name field 
[label] 


{label] 


blank 


[label] 


label 
blank 
blank 


blank 


symbol 
symbol 


blank 


blank 


blank 


blank 


[label] 


id char 


blank 


blank 


Mnemonic 


CSECT 


DC 


DROP 


DS 


DSECT 
EJECT 
END 


ENTRY 


EQU 
EQUR 


EXTRN 


ORG 


PRINT 


SPACE 


START 


TITLE 


USING 


WXTRN 


Appendix H. Assembler Instruction Summary 


Operand field Notes 


blank 


[dup] type [mods] ‘ins Pepnday a. 


1—8 absolute register expressions, 2 
separated by commas 


dup] type [mods ‘value’ 

[dup] type [mods] fet [opnd2,) ... 
blank 

blank 

relocatable expression OR blank 3 


one-or more relocatable symbols 
(entry symbols), separated by 


commas 
expression 4 
absolute expression 7 


one or more relocatable symbols 
(external symbols), separated by 
commas 


relocatable expression OR blank 


ON GEN DATA 
OFF NOGEN NODATA 


decimal value from 1—255 OR 5 
blank 
self-defining term OR blank 6 


character string up to 100 
characters, enclosed in apostrophes 


addr, reg 1,2 
one or more relocatable symbols 


(weak external symbols), 
separated by commas 
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H-2 


SC34-0074 


Notes. 


1. 


Code any absolute or relocatable expression for the addr operand. Usually, you code either a 
single relocatable symbol or a self-defining term. 


For a register operand, code any register expression that has a value of 0 through 7. 


If you choose to code the operand in this instruction, you usually code a single relocatable symbol 
or a location counter reference. 


Code any relocatable or absolute expression. Usually, you code a decimal or hexadecimal self- 
defining term, or a combination of a previously defined symbol and a self-defining term. 


. If you choose to code the operand in this instruction, you must code a decimal self-defining term. 


If you choose to code the operand in this instruction, you usually code a hexadecumal self- 
defining term. 


Code any absolute expression that has a value of 0 through 7. 


Appendix J. Macro Language Instruction Summary 


Name field Mnemonic Operand field Notes 
(calling instruction) —————_————_ [label ] macro name zero to 100 operands, separated 
by commas 
(prototype statement) ——————————>-_ [label] macro name zero to 100 symbolic parameters, 


separated by commas 


blank ACTR any valid SETA expression 1 
sequence symbol or blank AGO sequence symbol 
sequence symbol or blank AIF logical expression enclosed in 2 


parentheses, immediately followed 
by a sequence symbol with no 
intervening blanks 


sequence symbol ANOP blank 

blank GBLA one or more variable symbols to 
be used:as SET symbols, separated 
by commas 

blank GBLB one or more variable symbols to be 
used as SET symbols, separated by 
commas 

blank GBLC one or more variable symbols to be 
used as SET symbols, separated by 
commas 

blank LCLA one or more variable symbols to be 
used as SET symbols, separated by 
commas 

blank LCLB one or more variable symbols to be 
used as SET symbols, separated by 
commas 

blank LCLC one or more variable symbols to be 
used as SET symbols, separated by 
commas 

blank MACRO blank 

[label] MEND blank 

[label] MEXIT blank 

[label] MNOTE message specification 

symbol SETA arithmetic expression 1 

symbol SETB one of 3 options 

symbol SETC one of 4 options 
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Notes. 

1. Normally, you code this operand as a decimal self-defining term. 

2. Logical expressions contain combinations of variable symbols, logical and relational operators, 
and arithmetic and character expressions. Normally, you code this operand in the form: 


(variable-symbol relational-operator self-defining term) or 
(variable-symbol relational-operator ‘character-string’). 
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Appendix K. Reference Aid for Coding I/O Instructions 


Immediate device control block (IDCB) format 
0 7 8 15 


EA 
EA +1 Data word/DCB address 


16 31 


Command field (Bits 0O—7) 


0 1 2 3 4 7 


Command descriptions 
Field format Meaning 


Write 

Write 
Control 
Prepare 
Device reset 
Start 

Start cycle steal status 
Read 

Read 

Read status 
Read ID 
Halt 1/0 


—-_ ©Oooodd69odd & Oo & © 
= © © coc CO | -| +. FF YF EF 
= =| =-&— Oo OC fF =| =e & CO O&O 
- Co Oo FF OF | -|§ SF SC Oo KF O&O 
CoO Kher Kr OK mK 
Co KKM Kr OK KK 
CORK KK KK Oo KK MK 
CoCo KM KH KK Oo KK 
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Device control block (DCB) format 


Data address 





Control word format 


0 1 2 3 > 78 


4 
PCI 


15 


B\B\AWDRABA % 
 \S\Y\EVA\ SE \ 
® %\SB\% & \ © 2 
e\6¢\ @ O, 
<S % e @ ‘aN : Q 
os a \S fe) e > 
%\% % % to) 
e, \ o\ % e 
$ 6\% 
% &,\ * 
% 3. 
ee 


IO instruction condition code settings (LSR bits 0, 1, 2) 


Value 


NAR WON FE © 


Meaning 


Device not attached 

Busy 

Busy after reset 

Command reject 
Intervention required 
Interface data check (parity) 
Controller busy 

Satisfactory 


Device interrupt condition code settings (LSR bits 0, 1, 2) 


Value 


“AOA RhWN KH © 


Interrupt status byte (ISB) (presented with device interrupt CC = 2 or 6) 


DPC ISB 


Bit 0 
Bit 1 
Bits 2—7 


Cycle Steal ISB 
Bit 0 
Bit 1 
Bit 2 
Bit 3 
Bit 4 
Bit 5 
Bit 6 
Bit 7 


Meaning 


Controller end 

Program-controlled interrupt (PCI) 
Exception 

Device end 

Attention 

Attention and PCI 

Attention and exception 
Attention and device end 


Device-dependent status available 
Delayed command reject 
Device-dependent 


Device-dependent status available 
Delayed command reject 

Record is incorrect length 

DCB specification check 

Storage data check 

Invalid storage address 

Protect check 

Interface data check 
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&SYSLIST 6-19 
&SYSNDX 6-21 
&SYSPARM 6-22 


A-type address constant 5-26 
AB, add byte 4-20 
abcnt 4-4 
ABI, add byte immediate 4-20 
absolute expressions 2-13 
ACTR—assembly loop counter 6-58 
ACY, add carry indicator 4-21 
AD, add doubleword 4-21 
add instructions (see arithmetic instructions) 
addition, unsigned 3-6 
addr 4-4 
address argument, five-bit 3-13 
address argument, four-bit 3-11 
address arguments, instruction length 3-14 
address key register (AKR) 3-4 
addresses and addressing 1-5 
addr4 4-4 
addr5 4-4 
AGO-unconditional branch 6-57 
AlF—conditional branch 6-57 
AKR, address key register 3-4 
alphameric characters 2-6 
AND word immediate 4-96 
ANOP-assembly no operation 6-59 
arithmetic (SETA) expressions 6-50 
arithmetic instructions 4-20 
add byte (AB) 4-20 
add carry indicator (ACY) 4-21 
add doubleword (AD) 4-21 
add word (AW) 4-22 
add word immediate (AWI) 4-23 
add word with carry (AWCY) 4-24 
complement register (CMR) 4-32 
divide byte (DB) 4-30 
divide doubleword (DD) 4-30 
divide word (DW) 4-31 
multiply byte (MB) 4-28 
multiply doubleword (MD) 4-29 
multiply word (MW) 4-29 
subtract byte (SB) 4-24 
subtract carry indicator (SCY) 4-25 
subtract doubleword (SD) 4-25 
subtract word (SW) 4-26 
subtract word immediate (SWI) 4-27 
subtract word with carry (SWCY) 4-28 
arithmetic parentheses 2-17 
arithmetic value, SETA 6-44 
ASCII B-1 
ASCII character constant (S) 5-19 
assembler instruction summary H-1 


Index 


assembler instructions 5-1 


CSECT—control section 5-36 

DC—define constant 5-5 

DROP—drop base register 5-46 

DS instruction 5-28 

DSECT—dummy section 5-37 
EJECT-—start new page 5-56 

END-—end assembly 5-31 
ENTRY-—identify entry point symbol 5-50 
EQU-—equate symbol 5-3 

EQUR-—equate register 5-4 
EXTRN-identify external symbol 5-51 
ORG -set location counter 5-53 
PRINT—print optional data 5-55 
SPACE-space listing 5-57 

START-—start assembly 5-35 
TITLE—identify assembly output 5-56 
USING instruction format 5-44 
WXTRN-identify weak externalsymbol 5-52 


assembler language, definition of 1-3 


assembler instructions 1-3 
machine instructions 1-3 
macro instructions 1-3 


assembler language operand symbols 4-4 


abcnt 4-4 
addr 44 
addr4 44 
addr5 44 
bitdisp 4-5 
byte 4-5 
cntl6 4-5 
ent31 4-5 
cond 4-5 
disp 4-5 
freg 4-5 
jaddr 4-5 
jdisp 4-6 
longaddr 4-6 
reg 4-6 
teg’"* 4-6 
reg’~* 4-6 
teg’"’ 4-6 
ubyte 4-6 
veon 4-6 
waddr 4-6 
wdisp 4-6 
word 4-6 


assembler language structure 2-6 


attribute references 2-11 
character set 2-6 

location counter reference 2-10 
machine instructions 2-6 
macro instructions 2-6 
restrictions on symbols 2-8 
self-defining terms 2-11 

source module 2-6 

special characters 2-6 


Index 


assembler language structure (continued) 
symbol table 2-7 
symbols 2-7 
terms 2-6 
assembler program 1-3 
definitionof 1-3 
diagram 1-4 
assembler program listing 7-3 
cross-reference 7-7 
diagnostics 7-8 
external symbol dictionary 7-3 
relocation dictionary 7-7 
source and object program 7-6 
Statistics 7-8 
assembly language, conditional 6-35 
assembly loop counter, ACTR 6-58 
assembly no operation, ANOP 6-59 
attribute references 2-11 
binary self-defining term 2-11 
decimal self-defining term 2-11 
EBCDIC character self-defining term 2-12 
hexadecimal self-defining term 2-12 
AW, add word 4-22 
AWCY, add word with carry 4-24 
AWI, add word immediate 4-23 


B, branch 4-33 

BAL, branch and link 4-33 

BALS, branch and link short 4-34 
BALX, branch and link external 4-34 
base register, storage address 3-14 
base register, word displacement 3-10 
base register, word displacement short 3-9 
BC, branch on condition 4-40 

BCC, branch on condition code 4-40 
BCY, branch oncarry 4-39 

BE, branch on equal 4-41 

BER, branch onerror 4-42 

BEV, branch oneven 4-42 


BGE, branch on arithmetically greater than or equal 4-43 


BGT, branch on arithmetically greater than 4-42 
binary constant (B) 5-21 

binary self-defining term 2-11 

binary subtract 3-6 

binary to decimal conversion A-2 

binary to hexadecimal conversion A-2 

binary value, SETB 6-46 

bitdisp 4-5 

BLE, branch on arithmetically less than or equal 4-44 
BLGE, branch on logically greater than orequal 4-45 
BLGT, branch on logically greater than 4-44 
BLLE, branch on logically less than or equal 4-46 
BLLT, branch on logically less than 4-45 

BLT, branch on arithmetically less than 4-43 
BMIX, branch if mixed 4-36 

BN, branch on negative 4-46 

BNC, branch on not condition 4-47 

BNCC, branch on not condition code 4-48 
BNCY, branch on no carry 4-47 

BNE, branch on not equal 4-49 

BNER, branch on not error 4-49 
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BNEV, branch on noteven 4-49 
BNMIX, branch if not mixed 4-36 
BNN, branch on not negative 4-50 
BNOFF, branch if not off 4-37 
BNON, branch if noton 4-37 
BNOV, branch on not overflow 4-50 
BNP, branch on not positive 4-51 
BNZ, branch on not zero 4-51 
BOFF, branch if off 4-38 
BON, branch ifon 4-38 
boundaries, field 2-3 
BOV, branch on overflow 4-52 
BP, branch on positive 4-52 
branching 6-56 
ACTR~—assembly loop counter 6-58 
AGO-unconditional branch 6-57 
AlF—conditional branch 6-57 
ANOP-—assembly no operation 6-59 
branching instructions 4-33 
branch (B) 4-33 
branch and link (BAL) 4-33 
branch and link external (BALX) 4-34 
branch and link short (BALS) 4-34 
_ branch external (BX) 4-35 
branch if mixed (BMIX) 4-36 
branch if not mixed (BNMIX) 4-36 
branch if not off (BNOFF) 4-37 
branch ifnoton(BNON) 4-37 
branch if off (BOFF) 4-38 
branch ifon (BON) 4-38 
branch indexed short (BXS) 4-39 
branch on arithmetically greater than (BGT) 442 
branch on arithmetically greater than or equal 
(BGE) 4-43 
branch on arithmetically less than (BLT) 4-43 


branch on arithmetically less than or equal (BLE) 4-44 


branch on carry (BCY) 4-39 

branch on condition (BC) 440 

branch on condition code (BCC) 4-40 

branch on equal (BE) 4-41 

branch onerror (BER) 4-42 

branch on even (BEV) 4-42 

branch on logically greater than (BLGT) 444 


branch on logically greater than or equal (BLGE) 4-45 


branch on logically less than (BLLT) 445 
branch on logically less than or equal (BLLE) 4-46 
branch on negative (BN) 4-46 
branch on no carry (BNCY) 4-47 
branch on not condition (BNC) 4-47 
branch on not condition code (BNCC) 448 
branch on not equal (BNE) 4-49 
branch on not error (BNER) 4-49 
branch on not even (BNEV) 4-49 
branch on not negative (BNN) 4-50 
branch on not overflow (BNOV) 4-50 
branch on not positive (BNP) 4-51 
branch on not zero (BNZ) 4-51 
branch on overflow (BOV) 4-52 
branch on positive (BP) 4-52 
branch on zero (BZ) 4-53 
no operation (NOP) 4-53 
BX, branch external 4-35 


BXS, branch indexed short 4-39 
byte 4-5 
BZ, branch on zero 4-53 


calling macro instruction 6-23 
keyword parameters 6-26 
name field 6-24 
operands 6-24 
operation field 6-24 
positional parameters 6-25 
carry indicator 3-8 
CB, compare byte 4-85 
CBI, compare byte immediate 4-90 
CD, compare doubleword 4-91 
CFED, compare byte field equal and decrement 4-85 
CFEN, compare byte field equal and increment 4-87 
CFNED, compare byte field not equal and decrement 4-88 
CFNEN, compare byte field not equal and increment 4-89 
character (SETC) expressions 6-51 
character set 2-6 
character strings 2-6 
character value, SETC 6-44 
Class interrupts 3-17 
CMR, complement register 4-32 
cntl6 4-5 
cnt31 4-5 
coding aids 1-5 
addresses and addressing 1-5 
data representation 1-5 
linkage between source modules 1-6 
program listing 1-7 
register usage 1-5 
relocatability 1-5 
segmenting a program 1-6 
symbolic representation 1-5 
coding assembler language instructions 4-4 
coding conventions 2-3 
coding form (GX28-6509) 2-3 
comments statement format 2-4 
continuation lines 2-4 
field boundaries 2-3 
continuation indicator field 2-3 
identification and sequence field 2-3 
statement field 2-3 
instruction statement format 2-4 
fixed format 2-5 
free format 2-5 
nameentry 2-5 
operand entry 2-5 
operation entry 2-5 
remarks entry 2-6 
coding form (GX28-6509) 2-1 
coding notes 4-3 
comment statements 6-5 
comments statement format 2-4 
compare instructions 4-84 
compare byte (CB) 4-85 
compare byte field equal and decrement (CFED) 4-85 
compare byte field equal and increment (CFEN) 4-87 
compare byte field not equal and decrement 
(CFNED) 4-88 


compare instructions (continued) 
compare byte field not equal and increment 
(CFNEN) 4-89 
compare byte immediate (CBI) 4-90 
compare doubleword (CD) 4-91 
compare word (CW) 4-91 
compare word immediate (CWI) 4-92 
scan byte field equal and decrement (SFED) 4-92 
scan byte field equal and increment (SFEN) 4-93 
scan byte field not equal and decrement (SFNED) 4-94 
scan byte field not equal and increment (SFNEN) 4-95 
complex relocatable expressions 2-15 
concatenation 6-13 
cond 4-5 
conditional assembly language 6-35 
data attributes 6-37 
count attribute (K) 6-38 
number attribute (N) 6-38 
type attribute (T) 6-38 
sequence symbols 6-39 
SET symbols 6-35 
conditional branch, AIF 6-57 
constants, summary of F-l 
continuation indicator field 2-3 
continuation lines 2-4 
control sections 5-31 
CSECT-—control section 5-36 
defining 5-35 . 
DSECT—dummy section 5-37 
first control section 5-33 
location counter setting 5-32 
START- start assembly 5-35 
typesof 5-32 
unnamed control section 5-34 
conventions, coding 2-3 
coding form (GX28-6509) 2-3 
comments statement format 2-4 
continuation lines 2-4 
field boundaries 2-3 
continuation indicator field 2-3 
identification and sequence field 2-3 
statement field 2-3 
instruction statement format 2-4 
fixed format 2-5 
free format 2-5 
nameentry 2-5 
operand entry 2-5 
operationentry 2-5 
remarks entry 2-6 
copy address key register (CPAKR) 4-111 
copy console data buffer (CPCON) 4-111 
copy current level (CPCL) 4-112 
copy floating level block (CPFLB) 4-130 
copy in-process flags (CPIPF) 4-112 
copy instruction space key (CPISK) 4-113 
copy interrupt mask register (CPIMR) 4-113 
copy level status block (CPLB) 4-114 
copy level status register (CPLSR) 4-109 
copy operandl key (CPOOK) (4955 processor only) 4-115 
copy operand2 key (CPOTK) (4955 processor only) 4-116 
copy processor status and reset (CPPSR) 4-116 
copy segmentation register (CPSR) (4955 processor 
only) 4-117 


Index 


copy storage key (CPSK) (4955 processor only) 4-118 

CPAKR, copy address key register 4-111 

CPCL, copy current level 4-112 

CPCON, copy console data buffer 4-111 

CPF LB, copy floating level block 4-130 

CPIMR, copy interrupt mask register 4-113 

CPIPF, copy in-process flags 4-112 

CPISK, copy instruction space key 4-113 

CPLB, copy level status block 4-114 

CPLSR, copy level status register 4-109 

CPOOK (4955 processor only), copy operand! key 4-115 

CPOTK (4955 processor only), copy operand2 key 4-116 

CPPSR, copy processor statusand reset 4-116 

CPSK (4955 processor only), copy storage key 4-118 

CPSR (4955 processor only), copy segmentation 
register 4-117 

creating macros 6-4 

cross-reference listing, sample 7-5 

CSECT—control section 5-36 

CW, compare word 4-91 

CWI, compare word immediate 4-92 


data movement instructions 4-7 
add byte immediate (ABI) 4-20 
fill byte field and decrement (FFD) 4-7 
interchange registers (IR) 4-9 
move address (MVA) 4-10 
move byte (MVB) 4-10 
move byte and zero (MVBZ) 4-11 
move byte field and decrement (MVFD) 4-12 
move byte field and increment (MVFN) 4-13 
move byte immediate (MVBI) 4-14 
move doubleword (MVD) 4-15 
move doubleword and zero (MVDZ) 4-16 
move word (MVW) 4-16 | 
move word and zero (MVWZ) 4-17 
move word immediate (MVWI) 4-17 
move word short (MVWS) 4-18 
data representation 1-5 
data stacks 3-20 
DB, divide byte 4-30 
DC—define constant 5-5 
DC operand rules 5-6 
DC operand subfield 5-8 
duplication factor 5-8 
exponent modidifer 5-15 
length modifier 5-10 
modifiers 5-10 
nominal value 5-17 
scale modifier 5-11 
type 5-9 
DD, divide doubleword 4-30 
decimal self-defining term 2-11 
decimal to binary conversion A-1 
decimal to hexadecimal conversion A-6 
defining data 5-5 
A-type address constant 5-26 
ASCII character constant (S) 5-19 
binary constant (B) 5-21 
DC—define constant 5-5 
DS instruction 5-28 
EBCDIC character constant (C) 5-18 
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defining data (continued) 
exponent modifier 5-15 
fixed-point constant (D) 5-23 
fixed-point constant (F) 5-22 
fixed-point constant (H) 5-23 
floating-point constant (E) 5-24 
floating-point constant (L) 5-25 
hexadecimal constant (X) 5-21 
padding constants 5-7 
PTTC/EBCD character constant (P) 5-20 
truncating constants 5-7 
V-type address constant 5-27 
W-type address constant 5-28 

device control block (DCB) format K-2 

device mask 3-16 

DIAG, diagnose 4-118 

diagnostics listing, sample 7-5 

DIS, disable 4-119 

disp 4-5 

divide instructions (see arithmetic instructions) 

DROP—drop base register 5-46 

DS instruction 5-28 

DSECT—dummy section 5-37 

dummy sections 1-6 

DW, divide word 4-31 


EBCDIC character constant (C) 5-18 
EBCDIC character self-defining term 2-12 
effective address generation 3-9 
base register, storage address 3-14 
base register, word displacement short 3-9 
base register word displacement 3-10 
five-bit address argument 3-13 
four-bit address argument 3-11 
EJECT—start new page 5-56 
EN, enable 4-120 
END—end assembly 5-31 
ENTRY-—identify entry point symbol 5-50 
EQU—equate symbol 2-7, 5-3 
EQUR-—equate register 2-7, 5-4 
error, location counter 2-10 
establishing addressability 5-38 
evaluation of expressions 2-16 
exclusive OR byte (XB) 4-96 
exclusive OR doubleword (XD) 4-97 
exclusive OR word (XW) 4-98 
exclusive OR word immediate (XWI) 4-98 
exponent modifier 5-15 
expressions 2-12 
absolute expressions 2-13 
sample code 2-14 
complex relocatable expressions 2-15 
evaluation of 2-16 
example of 2-12 
parentheses in instruction operands 2-17 
relocatable 2-15 
tules for coding 2-16 
expressions, arithmetic (SETA) 6-50 
expressions, character (SETC) 6-51 
expressions, logical (SETB) 6-52 
external symbol dictionary 7-3 
external symbol dictionary entries 5-34 
EXTRN-—identify external symbol 5-51 


FA, floating add 4-130 

FAD, floating add double 4-131 

FC, floating compare 4-132 

FCD, floating compare double 4-132 

FD, floating divide 4-133 

FDD, floating divide double 4-134 

FDIAG floating diagnose 4-133 

FFD, fill byte field and decrement 4-7 

FEN, fill byte field and increment 4-8 

field boundaries 2-3 

five-bit address argument 3-13 

fixed format 2-5 

fixed-point constant (D) 5-23 

fixed-point constant (F) 5-22 

fixed-point constant (H) 5-23 

fixed-point constants 5-12 

floating-point constant (E) 5-24 

floating-point constant (L) 5-25 

floating-point constants 4-14, 5-14 

floating-point instructions (4955 processor only) 4-128 
copy floating level block (CPFLB) 4-130 
floating add (FA) 4-130 
floating add double (FAD) 4-131 
floating compare (FC) 4-132 
floating compare double (FCD) 4-132 
floating diagnose (FDIAG) 4-133 
floating divide (FD) 4-133 
floating divide double (FDD) 4-134 
floating move (FMV) 4-134 
floating move and convert (FMVC) 4-136 
floating move and convert double (FMVCD) 4-137 
floating move double (FMVD) 4-135 
floating multiply (FM) 4-138 
floating multiply double (FMD) 4-138 
floating subtract (FS) 4-139 
floating subtract double (FSD) 4-140 
set floating level block (SEFLB) 4-140 

floating-point number representation 4-128 
double-precision 4-128 
single-precision 4-128 

floating-point registers 3-3 

FM, floating multiply 4-138 

FMD, floating multiply double 4-138 

FMV, floating move 4-134 

FMVC, floating move and convert 4-136 

FMVCD, floating move and convert double 4-137 

FMVD, floating move double 4-135 

form (GX28-6509), coding 2-3 

four-bit address argument 3-11 

free format 2-5 

freg 4-5 

FS, floating subtract 4-139 

FSD, floating subtract double 4-140 

functional characteristics 3-1 
indicators 3-6 
number representation 3-5 


GBLA, GBLB, and GBLC instructions 6-41 
general registers 3-3 
GX28-6509, coding form 2-3 


hardware adds or subtracts 3-6 
hexadecimal constant (X) 5-21 
hexadecimal self-defining term 2-12 
hexadecimal to decimal conversion A-6 


1/O instruction (IO) 4-121 
I/O status 3-15 
IAR, instruction address register 3-3 
identification and sequence field 2-3 
IIB, interrupt information byte 3-15 
IMR, interrupt mask register 3-4 
indicators 3-6 
carry 3-6 
other usesof 3-8 
overflow 3-6 
instruction address register (IAR) 3-3 
instruction length address arguments 3-14 
instruction statement format 2-4 
instructions, assembler 1-3, 2-6, 5-3 
instructions, machine 1-3, 2-6, 44 
instructions, macro 1-3, 2-6 
interchange operand keys (IOPK) (4955 processor 
only) 4-120 
interchange registers (IR) 4-9 
interrupt mask register (IMR) 3-4 
interrupt masking 3-16 
device mask 3-16 | 
interrupt mask register (IMR) 3-16 
summary mask 3-16 
interrupts, class 3-17 
invert register (VR) 4-99 
IO, operate I/O 4-121 
IOPK (4955 processor only) interchange operand 
keys 4-120 
IR, interchange registers 4-9 


J,jump 4-54 

jaddr 4-5 

JAL, jump and link 4-54 

JC, jump on condition 4-58 

JCT,jump oncount 4-59 

JCY,jump oncarry 4-58 

jdisp 4-6 

JE, jump onequal 4-60 

JEV,jump oneven 4-60 

JGE, jump on greater than or equal 4-61 
JGT, jump on greater than 4-61 

JLE, jump on less than or equal 4-62 
JLGE, jump on logically greater than or equal 4-63 
JLGT, jump on logically greater than 4-63 
JLLE, jump on logically less than or equal 4-65 
JLLT, jump on logically less than 4-64 
JLT, jump onless than 4-62 — 

JMIX, jump if mixed 4-55 

JN, jump on negative 4-65 

JNC, jump on not condition 4-66 
JNCY,jumponno carry 4-66 

JNE, jump on not equal 4-67 

JNEV, jump on noteven 4-67 

JNMIX, jump if not mixed 4-55 
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JNN, jump on not negative 4-68 
JNOFF, jump if not off 4-56 
JNON, jump ifnoton 4-56 
JNP, jump on not positive 4-68 
JNZ,jump onnot zero 4-69 
JOFF, jump if off 4-57 
JON, jump ifon 4-57 
JP, jump on positive 4-69 
jump instructions 4-54 
jump JJ) 4-54 
jump and link (JAL) 4-54 
jump if mixed (JMIX) 4-55 
jump if not mixed (JNMIX) 4-55 
jump if not off GNOFF) 4-56 
jump ifnoton(JNON) 4-56 
jump ifoff (JOFF) 4-57 
jump ifon (JON) 4-57 
jump oncarry (JCY) 4-58 
jump oncondition (JC) 4-58 
jump oncount (ICT) 4-59 
jump onequal JE) 4-60 
jump oneven (JEV) 4-60 
jump on greater than (JGT) 4-61 
jump on greater than or equal (JGE) 4-61 
jump onlessthan (JLT) 4-62 
jump on less than or equal (JLE) 4-62 
jump on logically greater than JLGT) 4-63 
jump on logically greater than or equal (JLGE) 4-63 
jump on logically less than JLLT) 4-64 
jump on logically less than or equal (JLLE) 4-65 
jump on negative (JN) 4-65 
jump on no carry (JNCY) 4-66 
jump on not condition (INC) 4-66 
jump on not equal (INE) 4-67 
jump on not even (JNEV) 4-67 
jump on not negative (JINN) 4-68 
_ jump on not positive INP) 4-68 
jump on not zero (JNZ) 4-69 
jump on positive JP) 4-69 
jump on zero (JZ) 4-70 
JZ,jumponzero 4-70 


language, assembler 1-3 

LCLA, LCLB, and LCLC instructions 6-40 

length modifier 5-10 

level exit (LEX) 4-121 

level status register (LSR) 3-4 

level switching, program-controlled 3-18 

LEX, level exit 4-121 

linkage between source modules 1-6 

linkage stacking 3-20 

LMB, load multiple and branch 4-80 

location counter error 2-10 

location counter reference 2-7, 2-10 

location counter set, ORG 5-53 

logical (SETB) expressions 6-52 

logical instructions 4-96 
AND word immediate (NWI) 4-96 
exclusive OR byte (XB) 4-96 
exclusive OR doubleword (XD) 4-97 
exclusive OR word (XW) 4-98 
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logical instructions (continued) 
exclusive or word immediate (XWI) 4-98 
invert register (VR) 4-99 
OR byte, (OB) 4-100 
OR doubleword (OD) 4-100 
OR word (OW) 4-101 
OR word immediate (OWI) 4-102 
reset bits byte (RBTB) 4-102 
reset bits doubleword (RBTD) 4-103 
reset bits word (RBTW) 4-104 
reset bits word immediate (RBTWI) 4-104 
test bit (TBT) 4-105 
test bit and invert (TBTV) 4-106 
test bit and reset (TBTR) 4-106 
test bit and set (TBTS) 4-107 
test word immediate (TWI) 4-108 
longaddr 4-6 
LSR, level status register 3-4 


machine instructions 1-3, 2-6,44 


macro instructions 1-3, 2-6 
macro language 6-1 
&SYSLIST 6-19 
&SYSNDX 6-21 
&SYSPARM 6-22 
calling macro instruction 6-23 
comment statements. 6-5 
concatenation 6-13 
creating macros 6-4 
MEXIT instruction 6-18 
MNOTE instruction 6-16 
model statements 6-5, 6-12 
processing statements 6-19 
symbolic parameters 6-8 
system variable symbols 6-19 
macro language instruction summary J-1 
marco language summary G-l 
mask, device 3-16 
mask, summary 3-16 
masking, interrupt 3-16 
MB, multiply byte 4-28 
MD, multiply doubleword 4-29 
MEXIT instruction 6-18 
MNOTE instruction 6-16 
model statements 6-5, 6-12 
modules, processor 3-3 
move instructions, (see data movement instructions) 
multiply instructions (see arithmetic instructions) 
MVA, move address 4-10 
MVB, move byte 4-10 
MVBI, move byte immediate 4-14 
MVBZ, move byte and zero 4-11 
MVD, move doubleword 4-15 
MVDZ, move doubleword and zero 4-16 
MVFD, move byte field and decrement 4-12 
MVEN, move byte field and increment 4-13 
MVW, move word 4-16 
MVWI, move word immediate 4-17 
MVWS, move word short 4-18 
MVWZ, move word and zero 4-17 
MW, multiply word 4-29 


name entry rules 2-5 

no operation (NOP) 4-53 

NOP, no operation 4-53 

number representation 3-5 
signed number 3-5 
unsigned number 3-5 

NWI, AND word immediate 4-96 


OB,OR byte 4-100 

OD, OR doubleword 4-100 
operand entry rules 2-5 
operands, parentheses in 2-17 
operate I/O (IO) 4-121 
operation entry rules 2-5 
ordinary symbols 2-7 

ORG-set location counter 5-53 
overflow indicator 3-8 

OW, ORword 4-101 

OWI, OR word immediate 4-102 


padding constants 5-7 
examplesof 5-7 
parentheses, arithmetic 2-17 
parentheses, syntactic 2-17 
parentheses in instruction operands 2-17 
PB, pop byte 4-80 
PD, pop doubleword 4-81 
perforated tape transmission code/extended binary coded 
decimal (PTTC/EBCD) C-1 
pop/push instructions 4-80 
pop byte (PB) 4-80 
pop doubleword (PD) 4-81 
pop word (PW) 4-82 
push byte (PSB) 4-82 
push doubleword (PSD) 4-83 
push word (PSW) 4-83 
predefined register symbols 2-8 
previously defined symbols 2-9 
PRINT—print optional data 5-55 
priority interrupt structure 3-15 
priority list for assembler instructions E-1 
privileged instructions 4-111 
copy address key register (CPAKR) 4-111 
copy console data buffer (CPCON) 4-111 
copy current level (CPCL) 4-112 
copy in-process flags (CPIPF) 4-112 
copy instruction space key (CPISK) 4-113 
copy interrupt mask register (CPIMR) 4-113 
copy level status block (CPLB) 4-114 
copy operand1 key (CPOOK) (4955 processor only) 4-115 
copy operand2 key (CPOTK) (4955 processor only) 4-116 
copy processor status and reset (CPPSR) 4-116 
copy segmentation register (CPSR) (4955 processor 
only) 4-117 
copy storage key (CPSK) (4955 processor only) 4-118 
diagnose (DIAG) 4-118 
disable (DIS) 4-119 
enable (EN) 4-120 
interchange operand keys (IOPK) (4955 processor 
only) 4-120 


privileged instructions (continued) 
level exit (LEX) 4-121 
operate I/O (IO) 4-121 
set address key register (SEAKR) (4955 processor 
only) 4-122 
set console data lights (SECON) 4-122 
set instruction space key (SEISK) (4955 processor 
only) 4-123 
set interrupt mask register (SEIMR) 4-123 
set level status block (SELB) 4-124 
set operand] key (SEOOK) 4-125 
set operand2 key (SEOTK) (4955 processor call) 4-126 
set segmentation register (SESR) (4955 processor 
call) 4-126 
set storage key (SESK) 4-127 
processing statements 6-5, 6-16 
processor, 4953 3-3 
processor, 4955 3-3 
processor modules 3-3 
processor status instructions 4-109 
copy level status register (CPLSR) 4-109 
set indicators (SEIND) 4-109 
stop (STOP) 4-110 
supervisor call (SVC) 4-110 
processor status word (PSW) 3-5 
program, assembler 1-3 
definition of 1-3 
diagram 1-4 
program check 3-17 
program-controlled level switching 3-18 
program listing 1-7 
program sectioning 5-30 
control sections 5-31 
CSECT—control section 5-36 
DSECT-—dummy section 5-37 
END-—end assembly 5-31 
source module 5-30 
START-start assembly 5-35 
PSB, push byte 4-82 
PSD, push doubleword 4-83 
pseudobinary PTTC/EBCD conversion D-1 
PSW, processor status word 3-5 
PSW, push word 4-83 
PTTC/EBCD character constant (P) 5-20 
PW, pop word 4-82 


RBTB, reset bits byte 4-102 
RBTD, reset bits doubleword 4-103 
RBTVW, reset bits word 4-104 
RBTWI, reset bits word immediate 4-104 
record formats 7-9 
end (END) record 7-12 
external symbol dictionary (ESD) 7-9 
relocation list dictionary (RLD) 7-11 
text (TXT) record 7-10 
reference aid for coding I/O instructions K-1l 
reg 4-6 
register, predefined symbols 2-8 
register usage 1-5 
registers 3-3 
address key register (AKR) 3-4 
floating-point registers 3-3 


Index 


registers (continued) 
general registers 3-3 
instruction address register (IAR) 3-3 
interrupt mask register (IMR) 34 
level status register (LSR) 3 
processor status word (PSW) 3-5 

rege?? 4-6 

reg'~> 4-6 

reg'~7 4-6 

relocatability 1-5 

relocatable expressions 2-15 

relocation dictionary 7-7 

remarks entry 2-6 

reset bits byte (RBTB) 4-102 

reset bits doubleword (RBTD) 4-103 

reset bits word (RBTW) 4-104 

reset bits word immediate (RBTWI) 4-104 

restrictions on symbols 2-8 
predefined register symbols 2-8 
previously defined symbols 2-9 
sample code 2-14 
unique definition 2-8 

rules for coding expressions 2-16 


SB, subtract byte 4-24 
scale modifier 5-11 
fixed-point constants 5-12 
floating-point constants 5-14 

scan byte field equal and increment (SFEN) 4-93 
scan byte field not equal and decrement (SFNED) 4-94 
scan byte field not equal and increment (SFNEN) 4-95 
SCY, subtract carry indicator 4-25 
SD, subtract doubleword 4-25 
SEAKR (4955 processor only), set address key 

register 4-122 
SECON, set console data lights 4-122 
SEF LB, set floating level block 4-140 
segmenting a program 1-6 
SEIMR, set interrupt mask register 4-123 
SEIND, set indicators 4-109 
SEISK (4955 processor only), set instruction space 

key 4-123 
SELB, set level status block 4-124 
self-defining terms 2-11 
SEOOK, set operandl key 4-125 
SEOTK (4955 processor only), set operand2 key 4-126 
sequence symbols 2-7 
SESK, set storage key 4-127 
SESR (4955 processor only), set segmentation 

register 4-126 
set address key register (SEAKR) (4955 processor 

only) 4-122 
set console data lights (SECON) 4-122 
set floating level block (SEFLB) 4-140 
set indicators (SEIND) 4-109 
set instruction space key (SEISK) (4955 processor 

only) 4-123 
set interrupt mask register (SEIMR) 4-123 
set level status block (SELB) 4-124 
set operandl key (SEOOK) 4-125 
set operand2 key (SEOTK) (4955 processor only) 4-126 
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set segmentation register (SESR) (4955 processor 


only) 4-126 
set storage key (SESK) 4-127 
SETA~—assign arithmetic value 6-44 
SETB—assign binary value 6-46 
SETC—assign character value 6-44 
SFED, scan byte field equal and decrement 


SFEN, scan byte field equal and increment 4-93 
SFNED, scan byte field not equal and decrement 4-94 
SFNEN, scan byte field not equal and increment 4-95 


shift instructions 4-71 
shift left and test (SLT) 4-74 
shift left and test double (SLTD) 4-75 
shift left circular (SLC) 4-71 
shift left circular double (SLCD) 4-72 
shift left logical (SLL) 4-72 
shift left logical double (SLLD) 4-73 
shift right arithmetic (SRA) 4-76 


shift right arithmetic double (SRAD) 4-76 


shift right logical (SRL) 4-77 
shift right logical double (SRLD) 4-78 
signed number 3-5 
SLC, shift left circular 4-71 
SLCD, shift left circular double 4-72 
SLL, shift left logical 4-72 
SLLD, shift left logical double 4-73 
SLT, shift left and test 4-74 
SLTD, shift left and test double 4-75 
source module 2-6, 5-30 
SPACE -space listing 5-57 
special characters 2-6 
SRA, shift right arithmetic 4-76 
SRAD, shift right arithmetic double 4-76 
SRL, shift right logical 4-77 
SRLD, shift right logical double 4-78 
stack instructions 4-79 
load multiple and branch (LMB) 4-80 
pop byte (PB) 4-80 
pop doubleword (PD) 4-81 
pop word (PW) 4-82 
push byte (PSB) 4-82 
push doubleword (PSD) 4-83 
push word (PSW) 4-83 
store multiple (STM) 4-79 
stack operations 3-20 
data stacks 3-20 
linkage stacking 3-20 
START-—start assembly 5-35 
statement field 2-3 
Statistics listing, sample 7-5 
STM, store multiple 4-79 
stop (STOP) 4-110 
storage addressing, rulesfor 3-8 
store multiple (STM) 4-79 
structure, assembler-language 2-6 
alphameric characters 2-6 
assembler instructions 2-6 
attribute references 2-11 
character set 2-6 
location counter reference 2-10 
machine instructions 2-6 
macro instructions 2-6 


structure, assembler-language (continued) 
self-defining terms 2-11 
source module 2-6 
special characters 2-6 
symbols 2-7 
symbols table 2-7 
terms 2-6 
subtract, binary 3-6 
subtract instructions (see arithmetic instructions) 
subtraction, unsigned 3-6 
summary mask 3-16 
summary of constants F-1 
supervisor call (SVC) 3-19, 4-110 
supervisor state 3-19 
SVC, supervisor call 3-19, 4-110 
SW, subtract word 4-26 
SWCY, subtract word with carry 4-28 
SWI, subtract word immediate 4-27 
symbol cross-reference table 2-7 
symbol definition sample 2-9 
symbol table 2-7 
symbolic addressing 5-38 
establishing addressability 5-38 
~ DROP-—drop base register 5-46 
USING—use base address register 5-40 
symbolic linkage 5-47 


ENTRY-—identify entry point symbol 5-50 


EXTRN-—identify external symbol 5-51 
WXTRN-identify weak external symbol 
symbolic parameter attributes 2-7 
symbolic parameters 6-8 
symbolic representation 5-3 
symbols 2-7 
predefined register 2-8 
previously defined 2-9 
restrictions on symbols 2-8 
symbols, system variable 6-19 
syntactic parentheses 2-17 
system variable symbols 6-19 
&SYSLIST 6-19 
&SYSNDX 6-21 
&SYSPARM 6-22 


TBT, test bit 4-105 
TBTR, test bit and reset 4-106 
TBTS, test bitand set 4-107 
TBTV, test bit andinvert 4-106 
terms 2-6 
test instructions (see logical instructions) 
TITLE—identify assembly output 5-56 
trace 3-17 
truncating constants 5-7 
examplesof 5-8 
TWI, test word immediate 4-108 


ubyte 4-6 

unconditional branch, AGO 6-57 
unsigned addition 3-6 

unsigned number 3-5 

unsigned subtraction 3-6 


USING-—use base address register 5-40 
USING instruction format 5-44 


V-type address constant 5-27 
variable symbols 2-7 

veon 4-6 

VR, invert register 4-99 


W-type address constant 5-28 


waddr 4-6 
wdisp 4-6 
word 4-6 


word displacement, base register 3-10 
word displacement short, base register 3-9 
WXTRN-identify weak external symbol 5-52 


XB, exclusive OR byte 4-96 

XD, exclusive OR doubleword 4-97 

XW, exclusive OR word 4-98 

XWI, exclusive OR word immediate 4-98 


4953 processor 3-3 
4955 processor 3-3 
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